63 lines
2.2 KiB
Markdown
63 lines
2.2 KiB
Markdown
|
# 建置與修復
|
|||
|
|
|
|||
|
|
以最小、安全的修改逐步修復建置和型別錯誤。
|
|||
|
|
|
|||
|
|
## 步驟 1：偵測建置系統
|
|||
|
|
|
|||
|
|
識別專案的建置工具並執行建置：
|
|||
|
|
|
|||
|
|
| 指標 | 建置指令 |
|
|||
|
|
|-----------|---------------|
|
|||
|
|
| `package.json` 含 `build` 腳本 | `npm run build` 或 `pnpm build` |
|
|||
|
|
| `tsconfig.json`（僅 TypeScript） | `npx tsc --noEmit` |
|
|||
|
|
| `Cargo.toml` | `cargo build 2>&1` |
|
|||
|
|
| `pom.xml` | `mvn compile` |
|
|||
|
|
| `build.gradle` | `./gradlew compileJava` |
|
|||
|
|
| `go.mod` | `go build ./...` |
|
|||
|
|
| `pyproject.toml` | `python -m py_compile` 或 `mypy .` |
|
|||
|
|
|
|||
|
|
## 步驟 2：解析並分組錯誤
|
|||
|
|
|
|||
|
|
1. 執行建置指令並擷取 stderr
|
|||
|
|
2. 依檔案路徑分組錯誤
|
|||
|
|
3. 依依賴順序排序（先修 import/型別，再修邏輯錯誤）
|
|||
|
|
4. 計算總錯誤數以追蹤進度
|
|||
|
|
|
|||
|
|
## 步驟 3：修復迴圈（一次一個錯誤）
|
|||
|
|
|
|||
|
|
對每個錯誤：
|
|||
|
|
|
|||
|
|
1. **讀取檔案** — 使用 Read 工具查看錯誤前後 10 行的情境
|
|||
|
|
2. **診斷** — 識別根本原因（缺少 import、型別錯誤、語法錯誤）
|
|||
|
|
3. **最小修復** — 使用 Edit 工具做最小幅度的修改來解決錯誤
|
|||
|
|
4. **重新建置** — 確認錯誤已消失且未引入新錯誤
|
|||
|
|
5. **繼續下一個** — 處理剩餘錯誤
|
|||
|
|
|
|||
|
|
## 步驟 4：防護機制
|
|||
|
|
|
|||
|
|
遇到以下情況時停止並詢問使用者：
|
|||
|
|
- 修復**引入的錯誤比解決的更多**
|
|||
|
|
- **同一錯誤在 3 次嘗試後仍然存在**（可能是更深層的問題）
|
|||
|
|
- 修復需要**架構變更**（不只是建置修復）
|
|||
|
|
- 建置錯誤源自**缺少依賴**（需要 `npm install`、`cargo add` 等）
|
|||
|
|
|
|||
|
|
## 步驟 5：摘要
|
|||
|
|
|
|||
|
|
顯示結果：
|
|||
|
|
- 已修復的錯誤（含檔案路徑）
|
|||
|
|
- 剩餘的錯誤（若有）
|
|||
|
|
- 引入的新錯誤（應為零）
|
|||
|
|
- 未解決問題的建議後續步驟
|
|||
|
|
|
|||
|
|
## 恢復策略
|
|||
|
|
|
|||
|
|
| 情況 | 行動 |
|
|||
|
|
|-----------|--------|
|
|||
|
|
| 缺少模組/import | 檢查套件是否已安裝；建議安裝指令 |
|
|||
|
|
| 型別不匹配 | 讀取兩個型別定義；修正較窄的型別 |
|
|||
|
|
| 循環依賴 | 用 import 圖識別循環；建議提取 |
|
|||
|
|
| 版本衝突 | 檢查 `package.json` / `Cargo.toml` 的版本約束 |
|
|||
|
|
| 建置工具設定錯誤 | 讀取設定檔；與正常預設值比較 |
|
|||
|
|
|
|||
|
|
為安全起見，一次修復一個錯誤。優先最小差異而非重構。
|