以下是一个典型的 Python 项目结构示例及规划说明,遵循 PEP 8 规范和行业最佳实践:
```bash
my_project/ # 项目根目录(全小写+下划线)
├── docs/ # 文档目录
│ └── api.md # API文档
├── src/ # 源代码目录(或使用项目名)
│ ├── my_project/ # 主包目录(与项目同名)
│ │ ├── __init__.py # 包初始化文件
│ │ ├── core/ # 核心业务逻辑
│ │ │ ├── __init__.py
│ │ │ ├── calculator.py # 单一功能模块
│ │ │ └── processor.py
│ │ ├── models/ # 数据模型
│ │ │ ├── __init__.py
│ │ │ └── user.py # 用户模型类
│ │ ├── utils/ # 工具函数
│ │ │ ├── __init__.py
│ │ │ ├── logger.py # 日志工具
│ │ │ └── helpers.py # 辅助函数
│ │ └── config.py # 配置文件处理
│ ├── scripts/ # 可执行脚本
│ │ └── setup_db.