如何解决_append_dispatcher()缺少必填参数'values'的错误？

这个错误基本和pandas的追加操作相关，常见原因及解决方法如下：

原因1：调用append方法时未传入要追加的对象 #

旧版pandas中，DataFrame.append()或Series.append()必须接收要追加的数据源（DataFrame、Series或字典），如果空调用append()，就会触发该错误。

错误示例：

import pandas as pd
df = pd.DataFrame({'col': [1, 2]})
df.append()  # 未传入要追加的values参数

修正方式：传入要追加的对象，比如：

df.append(pd.DataFrame({'col': [3]}))

原因2：使用pandas 2.0+版本（已移除append方法） #

pandas 2.0及以上版本彻底移除了append方法，此时调用df.append()会触发底层私有方法_append_dispatcher的参数错误，官方推荐用pd.concat()替代。

替代示例：
合并两个DataFrame：

import pandas as pd
df1 = pd.DataFrame({'col': [1, 2]})
df2 = pd.DataFrame({'col': [3, 4]})
# 替代df1.append(df2)
new_df = pd.concat([df1, df2], ignore_index=True)

追加单个字典：

dict_data = {'col': 5}
new_df = pd.concat([df1, pd.DataFrame([dict_data])], ignore_index=True)

原因3：误调用了私有方法_append_dispatcher #

不要直接调用_append_dispatcher，这是pandas内部的私有方法，仅用于内部逻辑分发，操作数据请使用公开的pd.concat()或其他官方API。

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