Python 的文件命名规则通常被称为 PEP 8 命名约定,具体到文件名(模块名)时,主要遵循 小写蛇形命名法

规范名称:

  • 小写蛇形命名,也叫 snake_case(全小写,单词间用下划线 _ 连接)

具体要求:

  1. 全部小写字母,不能有大写。
  2. 单词之间用 下划线 _ 分隔。
  3. 文件名应简短、有描述性。
  4. 文件名必须以字母或下划线开头(不建议用下划线开头),后续可以是字母、数字或下划线。
  5. 不要与 Python 标准库的模块名、关键字或内置函数名重名。

示例:

  • my_module.py
  • data_processor.py
  • http_client.py
  • MyModule.py(包含大写)
  • my-module.py(使用了连字符,会导致导入错误)
  • myModule.py(驼峰式,不是 Python 模块推荐风格)

为什么要遵守这个规则?

因为文件名就是模块名,用户通过 import 语句使用。采用全小写加下划线的形式,可以避免与类名(通常用驼峰式 PascalCase)冲突,也符合 Python 社区的惯例。

特殊情况:

  • __init__.py:前后双下划线,表示这是一个包的初始化文件(有特殊含义)。
  • _private.py:单下划线开头,约定表示该模块是内部/私有的(from module import * 不会导入它)。
  • 测试文件:通常以 test_ 开头,如 test_my_module.py
文档更新时间: 2026-06-07 02:28   作者:月影工作室
IT运维支持-AIWALY-月影工作室