Python中模块与包同名是否为良好实践？有无权威依据？

核心结论：合法但非通用最佳实践 #

这种包（目录calendar_manager）与内部模块（文件calendar_manager.py）同名的做法，既不违反Python语法规范，也未被PEP8明确禁止。但从社区通用实践来看，它属于小众模式，仅在datetime这类核心库中出现，并非主流选择。

权威依据与社区实践分析 #

• PEP8的规则空白：PEP8仅明确模块名用小写、可加下划线，包名用小写、尽量短（最初建议避免下划线，但社区已普遍接受下划线提升可读性），但未提及包与内部模块同名的场景。这种空白意味着语法允许，但需结合社区习惯判断合理性。
• 主流项目的普遍模式：绝大多数知名Python包采用「包目录作为命名空间，内部模块用细分名称」的结构，比如requests包下的api.py、session.py；若要对外暴露核心功能，通常在包的__init__.py中导入并重新导出，而非使用同名模块。
• 潜在的维护成本：
  • 导入语句from calendar_manager import calendar_manager略显冗余，增加开发者的认知负担
  • 新人维护时易混淆包与模块的边界，复杂项目中更易引发路径混淆或命名冲突

关于包名下划线的补充 #

你提到的用下划线命名包（如calendar_manager）而非连写（calendarmanager）的做法，是社区广泛接受的实用选择。虽然PEP8最初建议包名尽量不用下划线，但实际开发中，下划线的可读性优势远大于规范的字面要求，绝大多数现代项目（如pandas的子包、scikit-learn的模块）都采用下划线命名。

优化建议 #

如果想保留自然的命名逻辑，同时兼顾社区习惯，可以尝试两种方案：

1. 通过__init__.py简化导入：在包的__init__.py中导入模块内的核心对象，让用户直接通过包名访问：

   # calendar_manager/__init__.py
   from .calendar_manager import CalendarManager, main_function
   

   用户只需写import calendar_manager或from calendar_manager import CalendarManager，无需重复名称。
2. 合并代码到__init__.py：若模块功能单一，直接将代码放在包的__init__.py中，省去单独的同名模块。

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