<think>我们正在回答用户关于Python文件命名规则的问题。根据引用内容，我们可以总结如下： 1. 基本规则： - 只能包含字母、数字和下划线（引用[2]） - 不能以数字开头（引用[2][4]） - 不能使用Python关键字（引用[2]） - 区分大小写（引用[2]） 2. 命名建议： - 使用有意义的文件名（引用[1][4]） - 使用下划线或小驼峰命名法（引用[1]） - 避免与内置模块名相同（引用[1]） - 保持简洁（引用[1]） 3. 关于Shebang（#!）： - 只有被直接执行的文件才需要（引用[3]） 4. 示例： - 正确的：`my_module.py`（引用[4]） - 错误的：`MyModule.py`（包含大写，虽然合法但不推荐，因为模块名通常小写），`my-module.py`（连字符不合法），`2module.py`（数字开头不合法）（引用[4]） 注意：引用[5]中的例子是关于变量命名和代码的，与文件命名无关。 因此，我们可以将回答组织如下： </think> ### Python文件命名规则详解 #### 1. **基础命名规范** 根据Python官方要求，文件名必须满足： - **字符限制**：仅包含字母（a-z, A-Z）、数字（0-9）和下划线（_）[^2] - **开头限制**：禁止以数字开头（如`2module.py`无效）[^2][^4] - **大小写敏感**：`myfile.py`与`MyFile.py`被视为不同文件[^2] - **关键字规避**：避免使用Python关键字（如`if.py`, `for.py`等）[^2] #### 2. **命名风格建议** | 命名法 | 正确示例 | 错误示例 | 适用场景 | |----------------|-------------------|-------------------|------------------| | 下划线分隔 | `data_loader.py` | `DataLoader.py` | 标准推荐格式[^1] | | 小驼峰式 | `jsonUtils.py` | `json-utils.py` | 特殊项目约定[^1] | | 全小写 | `config.py` | `CONFIG.py` | 配置文件[^4] | **数学表达**：设有效文件名集合为$F$，则： $$ F = \{ f \mid f \in [a-zA-Z\_][a-zA-Z0-9\_]* \} $$ #### 3. **关键禁忌** 1. **冲突规避** - 禁止使用标准库模块名（如`math.py`, `os.py`）[^1][^4] - 原因：`import math`会优先加载当前目录的`math.py`而非标准库 2. **特殊符号禁止** 以下字符会导致导入失败： ```python # 非法命名示例 my-module.py # 连字符引发SyntaxError data@process.py # @符号非法 ``` #### 4. **Shebang规则** - **使用场景**：仅需在**直接执行的脚本**首行添加[^3] ```python #!/usr/bin/env python3 # Linux/Mac #!C:\Python39\python.exe # Windows ``` - **模块文件**：无需添加，解释器会忽略[^3] #### 5. **最佳实践** 1. **语义化命名** - 好：`image_processor.py`（描述功能） - 差：`tmp123.py`（无意义）[^1][^5] 2. **长度控制** 建议不超过25字符（避免路径操作困难）[^1] 3. **测试文件约定** 测试文件添加`test_`前缀： ```bash test_calculator.py # 单元测试文件 test_data_validation.py ``` > 📌 **关键原则**：文件名应像函数名一样表达核心功能[^5]