本文围绕在 Python 中如何获取变量名：技巧、原理与实战方法展开，聚焦变量名与对象之间的关系、以及在调试与测试中的实际用法。请注意，变量名本质上是命名空间中的标签，获取它们并非对对象“身份”的直接查询，而是通过帧和作用域来实现的。
在 Python 中获取变量名的技巧
变量名与对象的关系
变量名只是对象在当前命名空间中的绑定标签，并非对象的固有属性。一个对象可以被多个变量名引用，甚至同一个变量名在不同作用域有不同的绑定。理解这一点是掌握“获取变量名”技巧的前提。
在日常开发中，很多场景需要知道一个对象被哪些变量名引用，以便在调试、日志或单元测试中进行更清晰的追踪，然而这并不是对象自带的元数据。下面的实现思路是基于这一核心事实而设计的。下面的代码示例展示了如何在调用者的局部命名空间中查找绑定到某个对象的变量名。
import inspectdef var_names_of(obj):frame = inspect.currentframe()try:# 取调用者的局部命名空间caller_locals = frame.f_back.f_locals# 找到所有绑定到同一个对象的变量名names = [name for name, val in caller_locals.items() if val is obj]return namesfinally:# 解除引用，避免引用循环del framedef demo():a = [1, 2, 3]b = ac = [1, 2, 3]print(var_names_of(a)) # 可能输出: ['a', 'b']print(var_names_of(c)) # 可能输出: ['c']if __name__ == '__main__':demo()如何在实际场景中尝试获取变量名
要在运行时尝试找到绑定到某个对象的变量名，通常需要查看调用栈中的局部命名空间，并通过对象标识进行匹配。这是一个“有条件成立”的技巧，依赖于当前解释器实现对帧对象的支持，在不同的解释器或优化级别下可能有所不同。
在实际场景中，我们往往将该方法用于调试或测试辅助工具，而非生产业务逻辑的一部分。它的结果可能包含多种名称（如 a、b、alias），也可能因对象被垃圾回收、重新绑定等情况而改变。因此，请将其视为调试辅助工具，而非稳定的 API。
原理与实现细节
工作原理：名字、绑定与对象
在 Python 的运行时，变量名与对象之间存在绑定关系，但对象本身并不携带“所有名字”的信息。名称绑定是命名空间的职责，局部命名空间、全局命名空间以及内置命名空间共同组成了对象可能的位置。当我们通过帧对象的局部命名空间查询时，实际是在重新构建“从名字到对象的映射”，从而推断出对同一对象的各种引用名称。
因此，获取变量名的核心逻辑是“在调用者的局部命名空间中找出 val 是 obj 的所有键名”。这需要借助 inspect 等底层工具来访问当前帧及其父帧的命名空间，并且须注意对象的唯一性与多值绑定问题。
实现中的边界与限制
局部命名空间的遍历只对当前调用栈有效，对全局变量或对象在其他作用域中的绑定需要分别检查 f_globals、f_locals 的组合。另一方面，某些优化器/解释器实现可能对 locals() 的实时性有影响，导致结果不稳定。因此，这类技术应仅用于调试与测试场景，避免将其作为核心业务逻辑的一部分。
另外，对于同一对象在不同线程的绑定情况、以及通过属性/字典项等间接引用的情况，简单的“变量名查找”往往无法覆盖，因此需要结合的策略包括：显式传递名称、日志中包含对象标识、以及对关键对象建立统一的引用名表等。
实战示例：如何在代码中获取并利用变量名
在调试日志中显示变量名与值
通过结合 var_names_of 的实现，我们可以在调试日志中输出变量名与其绑定对象的值，帮助快速定位问题。请将该方法仅限于本地调试场景使用，以避免在生产环境中引入性能和可维护性风险。日志清晰性与可维护性是此技巧的直接收益。
下面给出一个示例，演示如何将变量名和对象值一起输出到日志中，方便定位谁在引用特定对象。
import inspectdef var_names_of(obj):frame = inspect.currentframe()try:caller = frame.f_backnames = [name for name, val in caller.f_locals.items() if val is obj]return namesfinally:del framedef log_with_names(label, obj):names = var_names_of(obj)name_str = ", ".join(names) if names else ""print(f"[LOG] {name_str}: {label} => {obj!r}")def demo():x = {"a": 1}y = xz = {"a": 1}log_with_names("polling result", x) # 输出: [LOG] x, y: polling result => {'a': 1}log_with_names("new data", z) # 输出: [LOG] z: new data => {'a': 1}demo() 在单元测试中进行变量名断言
单元测试有时需要验证某个对象绑定了哪些变量名，以确保重构后仍然维持了期望的绑定关系。利用 var_names_of，可以进行简单的断言来确保多对多的绑定关系仍然成立。断言的目标是验证名称绑定的正确性，而非对象本身。
以下示例演示如何在测试中断言对象绑定到预期的变量名集合上，从而在变更中快速发现命名空间的错配问题。
import unittest
import inspectdef var_names_of(obj):frame = inspect.currentframe()try:caller = frame.f_backnames = [name for name, val in caller.f_locals.items() if val is obj]return namesfinally:del frameclass TestVariableBindings(unittest.TestCase):def test_bindings(self):a = []b = ac = []self.assertEqual(set(var_names_of(a)), {"a", "b"})self.assertEqual(set(var_names_of(c)), {"c"})if __name__ == '__main__':unittest.main()通过以上示例，可以在调试与测试阶段提升对变量名绑定的可观测性。需要注意的是，该方法对不同实现、不同优化级别的影响，以及对全局命名空间的覆盖程度，需要结合具体项目进行评估。
