2. 开发规范

2.1 单文件应用

• 文件结构示例

  # 文件注释
  import os
  import json
  
  DB_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/          # 单元测试