本文介绍如何利用 wrapt 模块的 enabled 参数机制，结合可变模块级变量，实现在不同脚本中动态控制装饰器的启用与禁用状态，无需修改被装饰函数本身。
本文介绍如何利用 wrapt 模块的 `enabled` 参数机制，结合可变模块级变量，实现在不同脚本中动态控制装饰器的启用与禁用状态，无需修改被装饰函数本身。
在 Python 开发中，装饰器常用于横切关注点（如日志、性能监控、权限校验等），但实际部署或调试时，往往需要临时禁用某些装饰逻辑——例如在集成测试中跳过耗时的缓存装饰器，或在特定环境关闭审计日志。wrapt 库提供了强大的 @wrapt.decorator(enabled=...) 机制，支持运行时条件启用，但其 enabled 参数仅接受可调用对象（如函数），而非布尔字面量。因此，关键在于让该回调函数能响应外部状态变化。
核心思路是：将启用开关封装为一个模块级可变变量，并通过一个轻量级函数读取该变量值。这样，其他脚本只需修改该变量，即可全局影响所有依赖它的装饰器行为。
以下为完整实现示例：
# script_1.py
import wrapt
# 定义可动态修改的启用标志（默认开启）
_enabled_flag = True
def _enabled():
return _enabled_flag
@wrapt.decorator(enabled=_enabled)
def my_decorator(wrapped, instance, args, kwargs):
print('decorator enabled')
return wrapped(*args, **kwargs)
@my_decorator
def my_function():
print('function enabled')此时，在 script_2.py 中，我们可通过导入模块并修改其内部变量来切换装饰器状态：
# script_2.py import script_1 # 注意：必须导入模块对象，而非仅函数 # 首次调用：装饰器生效 script_1.my_function() # 输出： # decorator enabled # function enabled # 动态禁用装饰器 script_1._enabled_flag = False # 再次调用：装饰器被跳过 script_1.my_function() # 输出： # function enabled
⚠️ 重要注意事项：
- 必须通过 import script_1 导入模块对象，再访问 script_1._enabled_flag；若仅 from script_1 import my_function，则无法修改原始模块中的 _enabled_flag（因变量未被导入到当前命名空间）。
- _enabled_flag 命名前缀下划线表示“受保护”，建议避免在模块外直接赋值为 True/False 以外的值，否则可能引发类型错误（_enabled() 返回非布尔值会导致 wrapt 行为未定义）。
- 若需多装饰器协同控制，可统一使用同一标志变量，或扩展为字典结构（如 {'log_decorator': True, 'cache_decorator': False}），并在 _enabled() 中按需返回对应键值。
该方案简洁、低侵入、符合 Python 惯例，适用于配置驱动型装饰器管理场景。配合环境变量（如 os.getenv('ENABLE_DECORATORS', 'true').lower() == 'true'）或配置中心，还可进一步实现环境感知的自动化开关。
