2025-07-20 18:08:31 +08:00
|
|
|
|
# 项目目录结构说明
|
|
|
|
|
|
|
|
|
|
|
|
## 核心结构概览
|
|
|
|
|
|
```plaintext
|
|
|
|
|
|
project/ # 项目根目录
|
|
|
|
|
|
├── src/ # ✅ 源代码包
|
|
|
|
|
|
│ └── __init__.py # 包标识文件（可定义公共API）[9,10](@ref)
|
|
|
|
|
|
├── tests/ # ✅ 测试目录（pytest自动发现用例）
|
|
|
|
|
|
│ └── test_example.py # 测试示例（需以`test_`前缀命名）[2,9](@ref)
|
|
|
|
|
|
├── .python-version # ✅ 指定Python版本（如3.11.4）
|
|
|
|
|
|
├── main.py # ✅ 主程序入口（CLI执行入口）
|
|
|
|
|
|
├── pyproject.toml # ✅ 全局配置（依赖/元数据/构建设置）[10](@ref)
|
|
|
|
|
|
├── README.md # ✅ 项目说明（必含安装/使用/发布指南）[6,7](@ref)
|
|
|
|
|
|
└── uv.lock # ✅ UV依赖快照（锁定版本号，可选但推荐）[8](@ref)
|
