Python 的文件命名规则通常被称为 PEP 8 命名约定,具体到文件名(模块名)时,主要遵循 小写蛇形命名法。
规范名称:
- 小写蛇形命名,也叫 snake_case(全小写,单词间用下划线
_连接)
具体要求:
- 全部小写字母,不能有大写。
- 单词之间用 下划线
_分隔。 - 文件名应简短、有描述性。
- 文件名必须以字母或下划线开头(不建议用下划线开头),后续可以是字母、数字或下划线。
- 不要与 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 作者:月影工作室