Pandas构建字典时DataFrame越界及白线位置异常问题排查

核心原因 #

1. 自动新增列导致形状异常：Pandas的df.at[label, label]是基于标签的索引，如果你初始创建的512×512 DataFrame的列标签中没有0（比如创建时列标签从1开始，或初始化方式错误），执行df.at[x,0]=255时会自动新增名为0的列，直接导致列数从512变为513，对应图像右侧出现多余白线。
2. 循环范围或索引遗漏导致NaN：最后一行出现NaN，大概率是你的循环没有覆盖到所有行（比如循环终止条件设为x < 511而非x < 512），或者行索引存在间隙，导致最后一行未被赋值，保留了DataFrame初始化时的默认NaN值。

解决步骤 #

1. 确保DataFrame初始化正确 #

创建严格的512×512结构，行/列索引均为0~511的连续整数，同时指定数据类型避免默认浮点型（减少NaN隐患）：

import pandas as pd
import numpy as np

# 初始化512x512的uint8类型DataFrame，所有值初始为0
df = pd.DataFrame(np.zeros((512, 512), dtype=np.uint8), 
                  index=range(512), 
                  columns=range(512))

2. 改用位置索引避免自动新增列 #

放弃基于标签的df.at，改用基于位置的df.iloc——它不会自动新增行列，而是直接操作对应位置的元素，能快速暴露索引越界问题：

# 遍历所有行，给第0列赋值255
for x in range(512):
    df.iloc[x, 0] = 255

3. 检查循环范围 #

确认循环覆盖所有512行（索引0到511）：

• 错误写法：for x in range(511)（仅处理前511行）
• 正确写法：for x in range(512)（处理全部512行）

4. 验证DataFrame结构 #

操作后检查形状和空值，确认问题解决：

print(df.shape)  # 应输出(512, 512)
print(df.iloc[-1].isna().any())  # 应输出False，说明最后一行无NaN

内容的提问来源于stack exchange，提问作者ct005