参考帖子向DataFrame df添加新行时遇语法错误，求排查

算力阿峰

2026-5-20

给DataFrame添加新行时常见的语法错误排查

嘿，我来帮你梳理一下给pandas的DataFrame添加新行时容易踩的语法坑～虽然你没贴具体代码，但我先列几个最常见的错误场景，你可以对照看看：

误用已弃用的append()方法且语法不规范
pandas 2.0及以上版本已经彻底弃用了df.append()方法，如果还在用这个方法不仅会报警告，要是参数格式不对还会直接语法报错。比如错误写法：
```
df.append({'col1': 1, 'col2': 2})  # 既已弃用，且未设置索引处理参数
```
正确的替代方式是用pd.concat()，注意要把新行转成二维的DataFrame结构：
```
import pandas as pd
new_row = pd.DataFrame({'col1': [1], 'col2': [2]})
df = pd.concat([df, new_row], ignore_index=True)
```
loc赋值时的语法疏漏
用loc直接添加新行时，要是忘记指定索引位置或者格式错误也会报错。比如错误写法：
```
df.loc[] = {'col1': 1, 'col2': 2}  # 缺少索引值，语法不完整
```
正确的做法是指定一个新的索引（比如用当前DataFrame的长度作为新索引）：
```
df.loc[len(df)] = {'col1': 1, 'col2': 2}
```
字典格式错误导致语法报错
构造新行的字典如果出现语法问题，比如列名没加引号、缺少逗号，会直接触发SyntaxError。比如错误写法：
```
# col2没加引号，会被当成未定义的变量
df.loc[len(df)] = {'col1': 1, col2: 2}
```
一定要确保字典的键（列名）是字符串格式，键值对之间用逗号分隔。
构造新行DataFrame时未用列表包裹值
直接用单个值构造新行DataFrame会报错，因为pandas要求列数据是可迭代对象。比如错误写法：
```
new_row = pd.DataFrame({'col1': 1, 'col2': 2})  # 单个值不是可迭代对象
```
正确的是把每个值放在列表里：
```
new_row = pd.DataFrame({'col1': [1], 'col2': [2]})
```