类中同名属性导致全局变量无法作为方法默认值的问题咨询

问题重现 #

示例代码：

import datetime as dt


class A:
    @property
    def dt(self):
        return 1

    def foo(self, dt_=dt.datetime.min):
        print(dt_ > dt.datetime.now())
        pass

执行报错：

Traceback (most recent call last):
  File "tmp.py", line 4, in <module>
    class A:
  File "tmp.py", line 9, in A
    def foo(self, dt_=dt.datetime.min):
AttributeError: 'property' object has no attribute 'datetime'

核心原因 #

这个问题的本质是Python在类定义阶段和函数调用阶段的作用域查找逻辑不同：

1. 默认参数表达式在类定义时立即求值 #

Python解析类的定义时，会逐行执行类体中的代码：

• 当定义完@property修饰的dt后，类作用域中就存在了一个名为dt的property对象。
• 紧接着定义foo方法时，默认参数dt_=dt.datetime.min的表达式会在类定义阶段直接求值。此时Python查找dt会优先匹配类作用域内的property对象，而非全局的datetime模块，因此触发AttributeError。

2. 方法内部代码在函数调用时求值 #

当调用A().foo()时，方法内部的dt.datetime.now()才会被执行：

• 函数内部的作用域查找顺序是「局部变量 → 全局变量 → 内置变量」，类作用域的成员不会自动进入函数的查找路径。
• 方法内部没有定义dt变量，所以Python会直接去全局作用域查找导入的datetime模块，因此能正常调用datetime.now()。

解决方法 #

如果需要在默认参数中使用全局的datetime模块，可以通过以下方式避免冲突：

• 给导入的模块换一个不会和类属性重名的别名，比如import datetime as datetime_mod
• 显式指定全局作用域，比如dt_=globals()['dt'].datetime.min

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