Python 项目标准目录结构(全场景完整版)
Python 项目没有「唯一绝对」的标准,但有「行业通用、约定俗成」的最佳实践结构。会根据「项目规模/用途」区分,从小型脚本项目 → 中大型工程化项目 → Web 框架项目,结构逐步规范,所有规范都遵循 Python 社区的通用约定,兼顾可读性、可维护性、协作效率。
一、基础通用版
适用于:个人项目、工具类项目、业务逻辑不复杂的中小型项目、内部自用项目。结构简洁够用,无冗余,规范且易上手,是 Python 项目的「最小完美结构」。
your_project/ # 项目根目录(项目名,自定义,比如 data_analysis/)
├── README.md
├── requirements.txt
├── .gitignore
├── src/
│ ├── __init__.py
│ ├── main.py
│ ├── core/
│ │ └── __init__.py
│ ├── utils/
│ │ └── __init__.py
│ └── config/
│ └── __init__.py
└── tests/
├── __init__.py
└── test_core.py

