Python嵌套类中静态类变量使用报错问题排查

我创建了使用静态变量作为类级参数和累加器的嵌套类：独立类可正常工作，继承自该独立类的嵌套类也能正常运行，但直接定义的嵌套类使用静态类变量时，解释器出现混淆并触发错误。

代码片段 #

class Cl_static_parameter_standalone:
    # static var common to all instances. Two uses: common settings, common accumulator
    c_n_counter : int = 0

    @staticmethod
    def increment() -> int:
        Cl_static_parameter_standalone.c_n_counter += 1
        return Cl_static_parameter_standalone.c_n_counter
    
class Cl_some_class:

    class Cl_static_parameter_inherited(Cl_static_parameter_standalone):
        pass

    class Cl_static_parameter_nested:
        c_n_counter : int = 0

        @staticmethod
        def increment() -> int:
            Cl_static_parameter_nested.c_n_counter += 1
            return Cl_static_parameter_nested.c_n_counter

    def __init__(self):
        return

    def do_something(self):
        
        print(f"Execute Standalone: {Cl_static_parameter_standalone.increment()}")
        print(f"Execute Inherited: {self.Cl_static_parameter_inherited.increment()}")
        print(f"Execute Nested: {self.Cl_static_parameter_nested.increment()}")
        return

my_instance = Cl_some_class()
my_instance.do_something()

报错输出 #

Execute Standalone: 1
Execute Inherited: 2      
Traceback (most recent call last):
  File "stack_overflow_class_static_parameter.py", line 52, in <module>
    my_instance.do_something()
    ~~~~~~~~~~~~~~~~~~~~~~~~^^
  File "stack_overflow_class_static_parameter.py", line 48, in do_something
    print(f"Execute Nested:{self.Cl_static_parameter_nested.increment()}")   
                            ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~^^      
  File "stack_overflow_class_static_parameter.py", line 38, in increment
    Cl_static_parameter_nested.c_n_counter += 1     
    ^^^^^^^^^^^^^^^^^^^^^^^^^^
NameError: name 'Cl_static_parameter_nested' is not defined. Did you mean: 'Cl_static_parameter_standalone'?

错误原因 #

Python的作用域规则导致了这个问题：

• 独立类Cl_static_parameter_standalone的名称在全局作用域，所以其静态方法能直接访问该类名。
• 继承的嵌套类Cl_static_parameter_inherited使用的是父类的increment方法，父类方法引用的是全局作用域的Cl_static_parameter_standalone，因此不会报错。
• 而直接定义的嵌套类Cl_static_parameter_nested，其静态方法内部无法直接访问自身的类名——静态方法没有绑定到类或实例，当前作用域中不存在Cl_static_parameter_nested这个名称，所以触发NameError。

修复方案 #

方案1：通过外层类引用嵌套类

修改嵌套类的静态方法，明确通过外层类Cl_some_class来访问嵌套类：

class Cl_some_class:
    # ... 其他代码保持不变 ...
    class Cl_static_parameter_nested:
        c_n_counter : int = 0

        @staticmethod
        def increment() -> int:
            # 用外层类+嵌套类的完整路径访问
            Cl_some_class.Cl_static_parameter_nested.c_n_counter += 1
            return Cl_some_class.Cl_static_parameter_nested.c_n_counter

方案2：改用@classmethod（推荐）

类方法会自动接收类本身作为第一个参数（通常命名为cls），可以直接通过cls访问类变量，这是更符合Python设计的写法，还能避免硬编码类名的问题：

class Cl_some_class:
    # ... 其他代码保持不变 ...
    class Cl_static_parameter_nested:
        c_n_counter : int = 0

        @classmethod
        def increment(cls) -> int:
            cls.c_n_counter += 1
            return cls.c_n_counter

修复后运行结果 #

执行代码后会正常输出：

Execute Standalone: 1
Execute Inherited: 2
Execute Nested: 1

内容的提问来源于stack exchange，提问作者05032 Mendicant Bias