在 Python 中,合理的文件命名不仅能提高代码的可读性,还能遵循 Python 社区的约定俗成。以下是 Python 文件命名的主要规则和最佳实践:
-
基本命名规则
- 只能包含字母(a-z, A-Z)、数字(0-9)和下划线(_)
- 不能以数字开头
- 不能使用 Python 关键字(如
if、for、class等) - 区分大小写(
myfile.py和MyFile.py是不同的文件)
-
推荐命名风格
- 采用全小写字母
- 多个单词之间用下划线分隔(snake_case 风格)
- 示例:
data_processor.py、user_authentication.py
-
特殊文件命名
- 程序入口文件通常命名为
main.py - 测试文件常以
test_为前缀,如test_utils.py - 包的初始化文件固定为
__init__.py(Python 3.3+ 后可省略,但仍推荐保留)
- 程序入口文件通常命名为
-
避免使用的命名方式
- 不要使用空格或特殊字符(如!、@、# 等)
- 避免使用单个字母作为文件名(除非是非常通用的文件,如
app.py) - 不要与 Python 标准库文件名冲突(如
json.py、sys.py等)

1万+

被折叠的 条评论
为什么被折叠?



