如何为Pandas DataFrame列标题集成可调用的附加信息？

当然可以实现，不需要用多级索引或单独字典，Pandas本身提供了自定义元数据存储的机制，能把附加信息直接集成到DataFrame里，平时不显示，需要时调用即可。下面是两种最实用的方法：

方法1：利用DataFrame的attrs属性存储列批注 #

attrs是Pandas为DataFrame/Series/Index对象设计的自定义属性容器，专门用来存这类不影响数据结构的附加信息。

示例代码：

import pandas as pd

# 创建示例DataFrame
df = pd.DataFrame({
    'user_id': [101, 102, 103],
    'order_amount': [299, 459, 199],
    'register_date': ['2023-01-05', '2023-03-12', '2023-05-20']
})

# 给列添加批注信息，存到DataFrame的attrs里
df.attrs['column_comments'] = {
    'user_id': '用户唯一标识，系统自动生成，不可修改',
    'order_amount': '订单总金额，包含运费与税费，单位：元',
    'register_date': '用户注册日期，格式为YYYY-MM-DD'
}

# 需要查看批注时，直接调用
print(df.attrs['column_comments']['order_amount'])
# 输出：订单总金额，包含运费与税费，单位：元

方法2：直接给列索引（Columns）添加attrs #

如果想把批注更紧密地和列名绑定，可以直接给df.columns这个Index对象添加属性：

# 给列索引添加批注字典
df.columns.attrs['comments'] = {
    'user_id': '用户唯一标识，系统自动生成，不可修改',
    'order_amount': '订单总金额，包含运费与税费，单位：元',
    'register_date': '用户注册日期，格式为YYYY-MM-DD'
}

# 获取批注
print(df.columns.attrs['comments']['register_date'])
# 输出：用户注册日期，格式为YYYY-MM-DD

注意事项 #

• 这类元数据不会在DataFrame的常规输出（如print(df)）中显示，完全符合你“平时不显示、需用时调用”的需求。
• 部分DataFrame操作（如df.copy()、df.merge()、分组聚合）可能会丢失attrs信息，操作后需要手动重新赋值；如果是用于可视化展示场景，也可以用pd.io.formats.style.Styler的批注功能实现前端悬浮显示。
• 对比你提到的方案：多级索引会把附加信息显示在列标题上，不够隐蔽；单独字典需要额外维护，而attrs直接绑定在DataFrame对象上，更易管理。

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