项目目录结构说明

核心结构概览

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)