为何在Django中无法获取变量名？

问题原因 #

你使用的get_variable_name函数依赖globals()获取全局作用域，但在Django的视图函数、类方法或其他局部作用域中，待调试的变量属于局部变量，并不在全局作用域内，因此函数无法匹配到对应的变量名，返回空数组。

单独测试时变量通常处于全局作用域，所以能正常运行；但Django业务代码大多写在局部作用域（如视图、模型方法）中，自然无法通过全局作用域找到目标变量。

修复方案 #

改用inspect模块获取调用者的局部作用域，而非当前函数的全局作用域。修改后的函数如下：

import inspect

def get_variable_name(variable):
    # 获取调用者的局部变量字典
    caller_locals = inspect.currentframe().f_back.f_locals
    # 遍历局部变量，找到指向同一对象的变量名
    return [var_name for var_name, var_val in caller_locals.items() if var_val is variable]

注意事项 #

• 如果多个变量指向同一个对象（如a = [1,2]; b = a），函数会返回所有匹配的变量名；
• 对于Python解释器优化复用的对象（如小整数、短字符串），可能出现误匹配，因为这类对象会被全局共享。

调试打印的优化封装 #

结合你的调试需求，可以把打印逻辑封装成一个函数，直接传入变量即可输出格式化内容：

import inspect

def debug_print(variable):
    caller_locals = inspect.currentframe().f_back.f_locals
    var_names = [name for name, val in caller_locals.items() if val is variable]
    var_name = var_names[0] if var_names else "UNKNOWN_VARIABLE"
    
    print('============================================')
    print(var_name.upper())
    print(variable)
    try:
        print(f'LENGTH : {len(variable)}')
    except TypeError:
        print('LENGTH : 不可计算（非可迭代/无长度属性）')
    print('============================================')

调用时只需写debug_print(your_variable)，无需手动传入变量名。

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