为什么logger.get_logger(__name__)总能正常工作?
为什么不直接通过解析
__file__提取模块名作为日志器名称 - 取值本身存在场景缺陷:在很多正常运行态下根本拿不到可靠的
__file__值,比如REPL交互环境编写的代码、Python内置的标准库模块、通过exec动态加载的内存态代码、PyInstaller/PyOxidizer这类打包后的单文件运行场景,要么__file__属性不存在会直接抛错,要么拿到的是打包工具生成的临时解压路径,根本没法提取出有可读性的模块名。 - 字符串解析的成本与误差:从文件路径提取模块名需要自行处理跨平台路径分隔符、文件后缀裁剪、相对路径转绝对路径、特殊路径字符兼容等逻辑,稍有处理疏漏就会得到格式不统一、带冗余前缀的日志器名称,反而破坏logging模块基于点分名称的层级继承规则。
- 违背Python的设计惯例:
__name__本身就是Python解释器为每个加载的模块维护的、全进程内唯一的身份标识,是模块加载阶段就保证正确性的标准属性,不需要额外的解析操作。
为什么
logger.get_logger(__name__)的写法在实际场景中始终稳定可用 - 大家担忧的
__main__命名冲突本质上不存在:- 单进程内解释器有严格的加载规则:只有被作为启动入口直接执行的代码,
__name__才会是__main__。所有通过import机制加载的模块,不管是业务代码还是第三方依赖,被导入时__name__永远是对应的完整模块路径,不会和入口脚本的__main__身份重叠。 - 即使某个第三方包是通过
python -m 包名的方式启动的,整个进程的入口就是这个包,不存在其他来源的__main__命名日志器,自然不会出现冲突。 - logging模块的日志器是全局单例实现,相同名称的日志器调用返回的永远是同一个实例,不存在两个同名日志器互相覆盖、干扰配置的问题。
- 单进程内解释器有严格的加载规则:只有被作为启动入口直接执行的代码,
- 天然适配logging模块的层级设计:logging的日志器是基于点分命名做层级继承的,比如名为
app、app.utils、app.utils.db的日志器,会自动继承上层日志器的输出配置、日志级别。而Python模块的导入路径天然就是点分格式,用__name__当日志器名称,刚好和项目的模块结构完全对齐,不需要手动维护日志器的层级关系。 - 符合常规的日志配置逻辑:你在项目入口脚本(也就是
__name__ == "__main__"判断块里)做全局日志配置时,本身就是在定义整个进程的日志行为,用__name__拿到的日志器,刚好可以方便地为入口脚本本身的日志设置独立的级别、输出规则,不会和被导入的第三方库、业务子模块的日志配置串线。
内容的提问来源于stack exchange,提问作者marlon
相关产品推荐
相关产品推荐

