Pandas元组列名赋值异常：不同IDE结果不一致问题

核心问题原因 #

这并非IDE的直接bug，而是Pandas的索引解析逻辑在不同执行环境下的触发差异：如果创建DataFrame时没显式保留列名的元组类型，PyCharm环境中Pandas可能会将元组列名自动拆分为MultiIndex层级，或者转换为字符串，导致at/loc赋值时匹配失败，进而创建新列；而Jupyter的交互式环境对元组类型的保留更严格，所以能正常匹配。

解决步骤 #

1. 正确创建带元组列名的DataFrame

必须确保列名是元组类型，避免隐性转换：

import pandas as pd

# 场景1：单个元组列
df = pd.DataFrame([1, 2], index=['a', 'b'], columns=[(1, 2)])

# 场景2：多个元组列（MultiIndex列）
df = pd.DataFrame(
    [[10, 20], [30, 40]],
    index=['a', 'b'],
    columns=[(1, 2), (3, 4)]
)

2. 精确匹配元组列名赋值

使用at或loc时，直接传入元组作为列索引，确保精确匹配：

# at方法赋值
df.at['a', (1, 2)] = 100

# loc方法赋值
df.loc['a', (1, 2)] = 100

3. 排查列名类型

如果问题仍存在，先确认列名的实际类型：

print(df.columns)
print(type(df.columns[0]))

如果输出的列名是字符串（比如"(1,2)"），说明创建DataFrame时元组被自动转换了，需要重新显式设置列名。

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