设置DataFrame列名时单双括号差异导致merge合并报错问题

核心区别 #

• 单括号['col1', 'col2']：设置的是普通一维列索引（Index）
  这是pandas设置列名的标准方式，赋值的是普通字符串列表，最终columns是一维的Index对象，每个列名是独立的字符串标签。执行后查看列名：

  print(total_views.columns)
  # 输出：Index(['national_id', 'total_views'], dtype='object')
  

• 双括号[['col1', 'col2']]：设置的是多级列索引（MultiIndex）
  传递嵌套列表时，pandas会将其解析为多级列索引，即使内层只有一组标签，也会生成单级的MultiIndex。每个列名实际是单元素元组，而非字符串。执行后查看列名：

  print(total_views.columns)
  # 输出：MultiIndex([('national_id',), ('total_views',)],)
  

报错原因 #

当你用双括号设置列名后，national_id并非字符串类型的列名，而是MultiIndex中的一个元组标签('national_id',)。此时执行merge并指定on='national_id'：

1. pandas无法匹配到字符串类型的列名，
2. 由于MultiIndex的结构特性，列名的唯一性检查逻辑会触发"The column label 'national_id' is not unique"错误——本质是因为pandas在处理MultiIndex的标签匹配时，无法正确识别你指定的字符串对应的唯一列。

总结 #

• 日常设置单级列名，用单括号的普通列表即可，这是常规用法。
• 双括号仅用于创建多级列索引（比如需要分层分类的列名场景），非必要不要随意使用。

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