如何处理需先初始化再使用的模块级变量？优化单例模块代码方案

我之前也踩过类似模块级全局变量的坑——隐式依赖调用顺序、调试起来头疼，还没法优雅处理未初始化的情况。针对你说的error_path空串是有效值的情况，这里有几个可行的优化方向：

1. 用哨兵对象区分“未初始化”和有效值 #

这是最轻量化的修改，不用动整体结构，只是引入一个唯一的哨兵对象来标记未初始化状态，替代原来的None：

import something

# 定义一个唯一的哨兵对象，用来区分未初始化和空字符串等有效值
_UNINITIALIZED = object()
_error_path = _UNINITIALIZED

def set_error_path(path):
    global _error_path
    _error_path = path

def get_error_path():
    if _error_path is _UNINITIALIZED:
        # 抛出明确的异常，而不是让后续代码处理莫名其妙的None
        raise RuntimeError("error_path 尚未初始化，请先调用 set_error_path()")
    return _error_path

这样既保留了原有的函数调用方式，又能在用户忘记调用setter时给出清晰的错误提示，完全避免了把None和空字符串混淆的问题。

2. 用单例类封装状态 #

如果希望把状态管理逻辑更清晰地封装起来，避免全局变量的隐式依赖，可以用单例类来实现：

import something

class ErrorPathManager:
    _instance = None
    # 类级别的哨兵，确保所有实例共享同一个标记
    _UNINITIALIZED = object()

    def __new__(cls):
        # 实现单例逻辑
        if cls._instance is None:
            cls._instance = super().__new__(cls)
            cls._instance._error_path = cls._UNINITIALIZED
        return cls._instance

    def set_error_path(self, path):
        # 这里还可以加一些参数验证逻辑，比如检查path是否符合要求
        self._error_path = path

    def get_error_path(self):
        if self._error_path is self._UNINITIALIZED:
            raise RuntimeError("error_path 尚未初始化，请先调用 set_error_path()")
        return self._error_path

# 使用方式
manager = ErrorPathManager()
manager.set_error_path("")  # 空字符串作为有效值没问题
print(manager.get_error_path())  # 输出空串

这种方式的好处是把状态和操作封装在一起，后续如果要加功能（比如重置状态、验证路径）会很方便，而且比全局变量更易于测试（测试时可以重置单例实例）。

3. 支持默认值的灵活Getter #

如果希望给调用方更多灵活性，允许在未初始化时返回一个默认值（而不是直接抛异常），可以修改getter函数：

import something

_UNINITIALIZED = object()
_error_path = _UNINITIALIZED

def set_error_path(path):
    global _error_path
    _error_path = path

def get_error_path(default=None):
    global _error_path
    if _error_path is _UNINITIALIZED:
        if default is not None:
            return default
        raise RuntimeError("error_path 尚未初始化，请先调用 set_error_path()")
    return _error_path

调用方可以根据场景选择：

# 场景1：必须要有初始化值，没设置就抛异常
path = get_error_path()
# 场景2：允许用默认值兜底
path = get_error_path(default="/tmp/default_error.log")

为什么不推荐原有的全局变量方案？ #

原代码的问题在于：

• 隐式依赖调用顺序，很容易出现get在set之前调用的情况，而且错误提示不清晰
• 全局变量难以追踪和调试，尤其是在多模块引用时
• 多线程环境下如果没有加锁，还可能出现竞态条件

根据你的实际场景选就行：如果只是小修小补，哨兵对象方案最省事；如果需要长期维护和扩展，单例类更合适；如果要兼顾灵活性，支持默认值的Getter是不错的选择。

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