如何动态修改Python包级全局配置变量并使函数默认参数同步生效？

我明白你想要实现的效果——像Pandas那样通过修改全局配置变量，让函数的默认参数自动跟着更新。问题出在Python函数默认参数的绑定时机上，咱们一步步来解决：

1. 先搞清楚为什么原来的写法不行 #

当你在base.py里定义：

def query(include_parent_=conf.INCLUDE_PARENTS, **kwargs):

Python会在函数定义的那一刻就把conf.INCLUDE_PARENTS的值（也就是False）计算并存储到函数的默认参数里，之后不管你怎么修改conf.INCLUDE_PARENTS，这个默认值都不会再变了——它已经被"固定"在函数定义时的状态。

2. 核心解决方案：延迟读取配置值 #

不要直接把配置变量作为默认参数，而是用一个特殊标记（比如None）作为默认值，然后在函数内部每次调用时去读取最新的配置值。修改base.py里的query函数：

# mypackage/base.py
import mypackage.config as conf

def query(include_parent_=None, **kwargs):
    # 如果用户没传这个参数，就用当前最新的配置值
    if include_parent_ is None:
        include_parent_ = conf.INCLUDE_PARENTS
    # 你的业务逻辑
    print(f"include_parent_的值是: {include_parent_}")

3. 确保配置能被全局访问 #

要让mp.config.INCLUDE_PARENTS能直接被修改，需要在config/__init__.py里把queries.py的变量导入进来：

# mypackage/config/__init__.py
from .queries import INCLUDE_PARENTS
from .completion import *  # 导入其他配置文件的变量
from .locals import *

然后在mypackage/__init__.py里把config和query暴露到包的顶层命名空间：

# mypackage/__init__.py
from .base import query
from . import config

4. 测试效果 #

现在你在IPython里的操作就能达到预期了：

In [1]: import mypackage as mp
In [2]: mp.config.INCLUDE_PARENTS = True
In [3]: mp.query()
Out[3]: include_parent_的值是: True
In [4]: mp.config.INCLUDE_PARENTS = False
In [5]: mp.query()
Out[5]: include_parent_的值是: False

进阶：用配置类管理更清晰 #

如果你的配置项越来越多，用类来分组管理会更优雅。比如修改queries.py：

# mypackage/config/queries.py
class QueryConfig:
    INCLUDE_PARENTS = False
    # 可以在这里添加更多查询相关的配置
    MAX_RESULTS = 100

# 创建一个全局实例
query_config = QueryConfig()

然后在config/__init__.py里导入：

# mypackage/config/__init__.py
from .queries import query_config
# 为了保持原来的使用习惯，可以把属性映射到模块层面
INCLUDE_PARENTS = query_config.INCLUDE_PARENTS

对应的base.py修改为：

# mypackage/base.py
import mypackage.config as conf

def query(include_parent_=None, **kwargs):
    if include_parent_ is None:
        include_parent_ = conf.query_config.INCLUDE_PARENTS
    # 业务逻辑

这样以后添加新配置时，直接在QueryConfig类里加属性就行，管理起来更有条理。

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