如何用Python将列表中DataFrame对应变量名转为字符串列表

前置说明 #

Python中的变量本质是指向内存对象的标签，同一个内存对象可以关联多个变量名，也可以没有任何具名变量（比如直接生成后传入列表的匿名对象）。要实现将全为DataFrame的对象列表转换为对应变量名的字符串列表，前提是列表内的DataFrame均为当前可访问作用域下绑定了具名变量的对象。

实现方式 #

方式1：通过inspect模块反向匹配变量名 #

该方法适用场景为：已经按照变量名构造好DataFrame列表，不需要调整原有列表的构造逻辑。

1. 导入依赖模块，构造示例场景：

import pandas as pd
import inspect

# 构造示例DataFrame
a = pd.DataFrame({"col1": [1, 2]})
b = pd.DataFrame({"col2": [3, 4]})
c = pd.DataFrame({"col3": [5, 6]})
d = pd.DataFrame({"col4": [7, 8]})
# 构造输入的DataFrame列表，注意不要将变量命名为list，避免覆盖Python内置类型
df_list = [a, b, c, d]

2. 定义匹配逻辑，通过内存对象id和作用域的变量名做映射：

def get_var_name_list(obj_list):
    # 获取调用方的执行帧，读取对应作用域的本地变量
    caller_frame = inspect.currentframe().f_back
    local_vars = caller_frame.f_locals
    # 建立内存对象id到变量名的映射
    id_to_name = {}
    for var_name, var_obj in local_vars.items():
        # 跳过以下划线开头的内置/临时变量
        if var_name.startswith("_"):
            continue
        id_to_name[id(var_obj)] = var_name
    # 按原列表顺序匹配对应名字，未匹配到则返回None
    return [id_to_name.get(obj) for obj in obj_list]

3. 调用得到结果：

str_result = get_var_name_list(df_list)
# 输出结果为 ['a', 'b', 'c', 'd']

该方式的注意事项：

• 如果同一个对象被多个变量名绑定，映射会保留遍历到的最后一个变量名，可根据实际命名规则调整匹配优先级
• 该方法受作用域限制：如果在独立函数内部调用该匹配逻辑，将无法读取到函数外部定义的变量名，导致匹配失败
• 如果列表内是没有绑定变量的匿名DataFrame，无法通过该方法匹配到对应名称

方式2：构造列表时同步维护名字映射（工程推荐） #

该方法适用场景为：可调整列表的构造逻辑，追求跨场景下的稳定性。
不需要依赖inspect模块反向匹配，在构造DataFrame列表时，直接将对象和对应的字符串名字绑定为元组结构：

import pandas as pd

# 构造示例DataFrame
a = pd.DataFrame({"col1": [1, 2]})
b = pd.DataFrame({"col2": [3, 4]})
c = pd.DataFrame({"col3": [5, 6]})
d = pd.DataFrame({"col4": [7, 8]})

# 构造同时包含名字和对象的元组列表
df_with_name = [
    ("a", a),
    ("b", b),
    ("c", c),
    ("d", d)
]
# 提取纯字符串列表
str_result = [item[0] for item in df_with_name]

该方式的优势：

• 完全不受Python作用域、执行栈规则的限制，跨函数、跨模块传递时不会出现匹配失效的问题
• 可灵活自定义每个DataFrame的标识名，不局限于代码内的变量名，比如可以给DataFrame配置更具业务含义的标签

常见踩坑提示 #

不要尝试通过以下错误路径获取名称：

• 直接对DataFrame对象调用str()：得到的是DataFrame的结构文本描述，和需求的变量名完全不匹配
• 直接访问df_obj.__name__：pandas的DataFrame类没有内置该属性，直接访问会抛出AttributeError

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