2. 开发规范

2.1 单文件应用

• 文件结构示例

  # 文件注释
  import os
  import jsonDB_PATH = "data.json"  # 常量放顶部def load_data():"""函数注释：加载数据"""if os.path.exists(DB_PATH):with open(DB_PATH, "r") as f:return json.load(f)return []if __name__ == "__main__":data = load_data()print(data)
  

2.2 单可执行项目

• 目录结构

  project/
  ├── app.py          # 主入口
  ├── config.py       # 配置（如数据库路径）
  ├── db/             # 数据存储
  ├── src/            # 业务逻辑
  │   └── utils.py    # 工具函数
  └── requirements.txt
  

2.3 多可执行项目

• 目录结构

  project/
  ├── bin/            # 可执行文件目录
  │   ├── cli.py
  │   └── gui.py
  ├── config/
  │   └── settings.py
  ├── src/            # 核心代码包
  └── tests/          # 单元测试