Python类变量相互引用：两类实现为何结果不同？

案例对比 #

可正常运行的类A #

class A:
  X = 1
  Y = X+1

实例化后运行结果：

In [8]: a = A()

In [9]: a.Y
Out[9]: 2

触发报错的TestDataSource类 #

class TestDataSource:
    import os

    CONFIG_DIR = os.path.join(os.getcwd(),"configs")
    FPATHS = [CONFIG_DIR + "schema{x}.yml" for x in range(1, 5)]

运行时抛出NameError：

NameError                                 Traceback (most recent call last)
Cell In[12], line 1
----> 1 class TestDataSource:
      2     import os
      4     CONFIG_DIR = os.path.join(os.getcwd(),"configs")

Cell In[12], line 5, in TestDataSource()
      2 import os
      4 CONFIG_DIR = os.path.join(os.getcwd(),"configs")
----> 5 FPATHS = [f"{CONFIG_DIR}/schema{x}.yml" for x in range(1, 5)]

Cell In[12], line 5, in <listcomp>(.0)
      2 import os
      4 CONFIG_DIR = os.path.join(os.getcwd(),"configs")
----> 5 FPATHS = [f"{CONFIG_DIR}/schema{x}.yml" for x in range(1, 5)]

NameError: name 'CONFIG_DIR' is not defined

尝试通过类名引用类变量仍报错：

FPATHS = [TestDataSource.CONFIG_DIR + "/schema{x}.yml" for x in range(1, 5)]

错误信息：

NameError: name 'TestDataSource' is not defined

问题核心原因 #

Python类定义时会创建临时的类作用域，但列表推导式会生成独立的局部作用域，这个作用域无法直接访问类定义阶段的变量：

• 类A中，Y = X+1是在类作用域内直接执行的赋值操作，能直接读取同作用域的X变量，因此正常运行。
• TestDataSource类中，FPATHS的赋值依赖列表推导式，推导式内部的代码运行在自身独立作用域中，既找不到全局作用域的CONFIG_DIR，也无法访问类作用域的CONFIG_DIR——两者作用域完全隔离。

另外，用TestDataSource.CONFIG_DIR也无效，因为类定义尚未完成，TestDataSource对象还未被创建，推导式内部根本找不到这个类名。

可行的解决方式 #

1. 用普通循环替代列表推导式 #

在类作用域内直接构建列表，避免触发独立作用域：

class TestDataSource:
    import os

    CONFIG_DIR = os.path.join(os.getcwd(),"configs")
    FPATHS = []
    for x in range(1, 5):
        FPATHS.append(f"{CONFIG_DIR}/schema{x}.yml")

2. 封装成静态方法 #

借助静态方法的作用域访问类变量：

class TestDataSource:
    import os

    CONFIG_DIR = os.path.join(os.getcwd(),"configs")
    
    @staticmethod
    def _generate_fpaths():
        return [f"{TestDataSource.CONFIG_DIR}/schema{x}.yml" for x in range(1, 5)]
    
    FPATHS = _generate_fpaths()

3. 转存为局部变量 #

先将类变量赋值给局部变量，推导式直接读取局部变量：

class TestDataSource:
    import os

    CONFIG_DIR = os.path.join(os.getcwd(),"configs")
    _local_config = CONFIG_DIR
    FPATHS = [f"{_local_config}/schema{x}.yml" for x in range(1, 5)]

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