Python文件通常存放在项目根目录、特定功能目录或虚拟环境目录中,关键存放原则包括:路径清晰、模块化分类和环境隔离。以下是具体存放场景和建议:
-
项目根目录
小型项目可直接将.py
文件放在根目录下,便于直接运行和导入。例如main.py
和config.py
这类核心文件通常置于此处。避免堆砌过多文件,建议通过子目录分类管理。 -
功能模块目录
按功能划分目录结构,例如:/utils/
存放工具类脚本/tests/
保存单元测试文件/models/
放置数据模型相关代码
这种结构符合Python包规范,需在目录中添加__init__.py
文件(可为空)以支持模块导入。
-
虚拟环境相关路径
使用venv
或conda
时,第三方库会安装在虚拟环境的Lib/site-packages/
中,但切勿手动修改该目录。项目自开发的依赖模块建议通过pip install -e .
以可编辑模式安装到虚拟环境。 -
系统路径与自定义路径
若需全局调用某些模块,可通过以下方式处理:- 将项目目录添加到
PYTHONPATH
环境变量 - 在代码中使用
sys.path.append()
临时添加路径
但需注意路径优先级问题,避免与系统库冲突。
- 将项目目录添加到
-
特殊场景存放
- Jupyter Notebook的
.ipynb
文件建议单独建立/notebooks/
目录 - 临时脚本可存放在
/tmp/
或/scratch/
目录 - 配置文件(如
.json
/.yaml
)推荐与代码分离,通过绝对或相对路径引用
- Jupyter Notebook的
合理规划文件位置能显著提升项目可维护性。建议结合os.path
标准库处理路径操作,并遵循PEP 8关于导入风格的约定。对于复杂项目,可使用setuptools
或poetry
工具规范目录结构。