Python中用全局变量实现函数注册是否合规？有无更优方案？

先给结论：全局变量方案在小场景下完全可破例使用，但确实有更优的封装方案 #

首先看你的原代码，有个小bug：get_function里应该写PLUGINS[func_name]而非PLUGINS["func_name"]，后者会硬编码查找名为"func_name"的函数，逻辑不对。

1. 全局变量方案的合理性 #

这种插件注册场景里，全局变量是实际开发中常见的简洁实现方式：

• 你的PLUGINS用全大写命名，符合Python常量的命名规范，能清晰传达这是一个全局状态的集合；
• 逻辑简单直接，不需要额外的封装代码，适合小型项目或快速原型开发。

但它的缺点也很明显：

• 全局状态会提升代码耦合度，其他模块可能意外修改PLUGINS字典，引发难以排查的问题；
• 单元测试时不好隔离状态，每次测试都需要重置PLUGINS，否则会影响测试结果。

2. 更优的替代方案 #

方案一：用类封装注册逻辑（最推荐，扩展性强）

把注册器做成类，用实例属性存储插件，既避免全局变量，还支持多插件集合（比如不同业务线的插件分开管理）：

class PluginRegistry:
    def __init__(self):
        self._plugins = {}  # 下划线开头表示内部属性，不建议外部直接操作
    
    def register(self, func):
        self._plugins[func.__name__] = func
        return func
    
    def get_function(self, func_name):
        return self._plugins.get(func_name, None)  # 用get避免KeyError

# 创建全局单例实例（可控的全局状态）
plugin_registry = PluginRegistry()

# 使用装饰器注册
@plugin_registry.register
def say_hello(name):
    return f"Hello {name}"

# 获取并调用函数
hello_func = plugin_registry.get_function("say_hello")
if hello_func:
    print(hello_func("Alice"))

这个方案的优势：

• 封装性好，外部只能通过register和get_function操作插件集合；
• 测试时可以创建新的PluginRegistry实例，完全隔离测试状态；
• 容易扩展，比如添加批量注册、插件去重等功能。

方案二：用闭包隐藏内部状态

通过嵌套函数把插件字典包裹在闭包里，外部无法直接访问，只能通过暴露的接口操作：

def create_plugin_registry():
    _plugins = {}
    
    def register(func):
        _plugins[func.__name__] = func
        return func
    
    def get_function(func_name):
        return _plugins.get(func_name)
    
    return register, get_function

# 生成注册和获取函数
register, get_function = create_plugin_registry()

@register
def say_hello(name):
    return f"Hello {name}"

# 使用
print(get_function("say_hello")("Bob"))

这种方案不需要定义类，代码更轻量化，适合不需要扩展的简单场景。

方案三：模块级别的私有变量

把注册逻辑放到单独的模块里，利用Python模块的单例特性，用私有变量存储插件：

# plugins.py
_plugins = {}  # 下划线开头，约定为模块内部变量

def register(func):
    _plugins[func.__name__] = func
    return func

def get_function(func_name):
    return _plugins.get(func_name)

在其他模块中导入使用：

from plugins import register, get_function

@register
def say_hello(name):
    return f"Hello {name}"

这种方式比全局变量更规范，把状态限制在模块内部，避免全局命名空间污染。

总结 #

• 如果是小型项目或快速验证功能，用全局变量完全没问题，只要注意命名规范和避免意外修改；
• 如果项目规模较大、需要更好的可维护性和可测试性，优先选择类封装的方案；
• 闭包或模块私有变量是轻量化的替代方案，适合简单场景。

内容的提问来源于stack exchange，提问作者polish-bear