一、Python项目标准结构
一个规范的Python项目包含以下核心部分：
my_project/
├── my_project/ # 主包目录（或 src/）
│ ├── __init__.py # 包初始化文件
│ ├── module1.py # 业务模块
│ └── subpackage/ # 子包
├── tests/ # 单元测试
├── docs/ # 文档
├── requirements.txt # 依赖清单
├── setup.py # 项目打包配置
├── README.md # 项目说明
├── .gitignore # Git忽略规则
└── LICENSE # 开源协议
核心设计思想：
- 模块化：通过包（Package）和模块（Module）组织代码（类比Java的包和类）
- 环境隔离：
requirements.txt管理依赖（类似Maven的pom.xml） - 自动化：测试目录（tests/）和CI/CD文件保障质量
二、Python文件类型全解析
| 类型 | 后缀 | 作用 | Java对照 |
|---|---|---|---|
| 代码文件 | .py | 源代码文件 | .java |
| 配置文件 | .yml/.env | 参数配置（数据库/密钥等） | application.properties |
| 依赖管理 | requirements.txt | 声明第三方依赖 | pom.xml |
| 测试文件 | test_*.py | 单元测试（pytest框架） | *Test.java |
| 构建部署 | Dockerfile | 容器化部署配置 | Dockerfile |
关键差异：
- Python通过文件后缀明确功能（如
test_*.py表示测试）- 虚拟环境目录（.venv/）实现环境隔离（类似Java的Maven本地仓库）
