Python声明可循环追加的空DataFrame报错：列数不匹配原因求解

错误原因 #

你遇到的AssertionError本质是数据列数和指定列名的列数不匹配。

你写的代码：

result_table = pd.DataFrame([[], [], [], [], []], columns = ["A", "B", "C", "D", "E"])

这里的[[], [], [], [], []]是5个空列表，每个空列表代表一行数据，但空列表里没有任何元素——pandas会判定你的输入数据只有0列，可你却指定了5个列名，两者冲突，所以抛出错误。

正确的空DataFrame声明方式 #

如果你需要的是一个有指定列名、但没有任何行数据的空DataFrame（方便后续循环追加），直接用列名参数初始化即可，不需要传递空列表：

import pandas as pd
result_table = pd.DataFrame(columns=["A", "B", "C", "D", "E"])

这样创建的DataFrame结构完全符合你的需求：5个列，0行，后续可以正常追加数据。

后续追加数据的建议 #

需要注意的是，pandas 2.0及以后版本中df.append()方法已经被标记为弃用，更推荐使用pd.concat()来批量追加数据（循环里每次追加效率很低，建议先把要追加的数据存到列表，最后一次性合并）：

# 示例：高效追加数据的流程
data_rows = []
for item in your_loop_items:
    # 假设每次生成一行数据，转为DataFrame格式
    new_row = pd.DataFrame({
        "A": [item.value_a],
        "B": [item.value_b],
        "C": [item.value_c],
        "D": [item.value_d],
        "E": [item.value_e]
    })
    data_rows.append(new_row)

# 最后一次性合并所有行
result_table = pd.concat(data_rows, ignore_index=True)

额外说明 #

如果你的初衷是创建5行空值数据的DataFrame（而不是完全空的），那需要让每个子列表的元素数量和列数一致，比如用None填充：

result_table = pd.DataFrame([[None]*5 for _ in range(5)], columns=["A", "B", "C", "D", "E"])

但这显然不是你要的“后续追加”场景的最优选择。

内容的提问来源于stack exchange，提问作者Waldemar Kołodziejczyk