Python函数默认参数在定义时求值一次，不会随模块级变量后续变化而更新；应使用None哨兵+运行时读取确保每次调用获取当前值。
Python 函数默认参数不能直接引用模块级常量？
可以，但必须注意：默认参数在函数定义时求值一次，不是每次调用时动态获取。如果你写 def f(x=MY_CONST):，且 MY_CONST 是模块级变量，那它确实会取定义时的值——但如果该常量后续被重新赋值（比如测试中 monkey patch），默认值不会变。
为什么 def f(x=CONFIG_TIMEOUT) 在 reload 后不更新？
因为 Python 解析函数定义时，就执行了右侧表达式并把结果存进 __defaults__。即使 CONFIG_TIMEOUT 是个全局变量，它只被读取一次。
- ✅ 安全场景：常量真不变（如
MAX_RETRY = 3）→ 直接用没问题 - ⚠️ 危险场景：常量可能被改（如从环境变量加载的
API_BASE_URL）→ 默认参数会“冻结”初始值 - ? 补救方式：用
None占位，内部做惰性读取
用 None 作哨兵实现运行时取值
这是最常用、最清晰的做法，确保每次调用都看到当前模块状态：
DEFAULT_TIMEOUT = 30def request(url, timeout=None): if timeout is None: timeout = DEFAULT_TIMEOUT
实际逻辑...
- 模块级变量变更后，新调用立即生效
- 兼容性好，所有 Python 版本都支持
- 避免误传
0或False被当成“未提供”，必要时可用object()哨兵
装饰器或闭包能绕过这个问题吗？
技术上可以，但没必要。例如用闭包生成函数：
Python之模块学习 中文WORD版
下载
本文档主要讲述的是Python之模块学习；python是由一系列的模块组成的，每个模块就是一个py为后缀的文件，同时模块也是一个命名空间，从而避免了变量名称冲突的问题。模块我们就可以理解为lib库，如果需要使用某个模块中的函数或对象，则要导入这个模块才可以使用，除了系统默认的模块（内置函数）不需要导入外。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看
def make_requester(timeout_const):
def request(url, timeout=timeout_const):
...
return request
request = make_requester(DEFAULT_TIMEOUT)
但这样增加了间接层，调试困难，且无法在模块顶层直接写 def request(...)。除非你明确需要“快照式配置”，否则纯属自找麻烦。
真正容易被忽略的是：很多人以为 import 重载后默认参数会刷新，其实不会——__defaults__ 是函数对象的一部分，跟模块对象解耦。改常量不等于改函数。
