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/          # 單元測試