PEP8与Python命名空间包命名规范冲突：下划线是否可用及实例咨询

为什么PEP 8和打包文档的命名建议不一致？ #

PEP 8是Python通用的代码风格指南，它推荐包名用简短全小写、不鼓励下划线，核心是延续Python早期社区的命名习惯，让代码整体风格更统一、易读。而命名空间包的打包文档推荐下划线写法（比如mynamespace_subpackage_a），是出于打包兼容性的实际需求：

• 传统的点分隔命名（mynamespace.subpackage）在部分旧版打包工具中，容易和常规的子包结构混淆，导致命名空间包的识别、分发出现问题；
• 下划线的写法能避开这类工具兼容性坑，同时清晰区分命名空间和子包的关系，是针对特定场景的务实方案。

命名空间包用下划线是否合规？ #

完全合规。PEP 8的规则并非强制要求，而是“风格建议”，社区允许在有合理场景需求时灵活调整。官方打包文档针对命名空间包给出的下划线写法，本身就是官方认可的例外方案，只要是为了适配命名空间包的打包需求，使用下划线完全符合社区规范。

含下划线的Python包实例 #

• scikit_learn：机器学习领域的知名包，虽然常用别名sklearn，但官方发布的包名是带下划线的；
• tensorflow_datasets：TensorFlow生态下的数据集工具包；
• pytorch_lightning：PyTorch的轻量化训练框架；
• sqlalchemy_utils：SQLAlchemy的扩展工具包。

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