Python命名空间：如何避免强制将符号注入全局命名空间

这个错误本质是Python变量作用域规则导致的：

• 你在类A代码块第一行写的logger = logging.getLogger('mylogger')是类A的类属性，归属于类A的命名空间，不是模块级全局变量。Python在函数/方法里查找裸写的变量名时，只会按「局部变量→外层嵌套函数变量→模块全局变量→内置变量」的顺序查找，不会自动搜索当前类的命名空间，所以直接写logger根本找不到你定义在类里的那个属性。
• 直接运行脚本不报错的原因完全是巧合：你在if __name__ == '__main__':分支里定义了一个模块全局的logger变量，脚本直接运行时这个分支会执行，全局作用域里刚好有logger，实例化A的时候方法里找变量刚好能命中。但当你作为模块导入时，__name__的值是模块名mypkg，这个分支的代码根本不会执行，模块全局里压根没有logger变量，自然抛出NameError。
• 你后来用global关键字注入的写法，本质是第一次实例化A的时候才往模块全局作用域塞logger变量，属于隐式修改全局状态，不仅时序上有风险（实例化A之前调用任何依赖这个logger的代码都会报错），代码可读性也很差，完全不推荐在生产代码里用。

根据你的使用场景选对应写法即可，都是Python社区通用的标准写法：

方案1：模块级全局logger（绝大多数场景推荐） #

直接在模块顶层定义logger，类和方法直接引用全局变量即可，这也是Python官方logging指南推荐的常规写法：

import logging

# 模块顶层定义，属于模块全局作用域，导入/直接运行都能访问
logger = logging.getLogger('mylogger')

class A:
    def __init__(self):
        logger.warning('initializing class A')

    def someMethod(self):
        logger.info('about to do something useful')

if __name__ == '__main__':
    # 直接运行时配置日志输出即可，不需要重复get logger
    logging.basicConfig(level=logging.WARNING)
    a = A()

这种写法逻辑清晰，没有隐式依赖，不管是直接运行脚本还是导入模块都能正常工作。

方案2：类绑定logger（适合类继承/日志隔离场景） #

如果你需要把logger和类绑定（比如子类要重写logger、做类维度的日志隔离），就显式引用类属性，不要裸写变量名：

import logging

class A:
    # 定义为类属性
    logger = logging.getLogger('mylogger')

    def __init__(self):
        # 显式通过类名访问类属性
        A.logger.warning('initializing class A')
        # 也可以写self.logger，子类继承重写logger时会自动调用子类的logger，灵活性更高
        # self.logger.warning('initializing class A')

    def someMethod(self):
        A.logger.info('about to do something useful')

if __name__ == '__main__':
    logging.basicConfig(level=logging.WARNING)
    a = A()

这种写法把logger的归属明确到类，避免污染模块全局命名空间，适合复杂的类继承场景。

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