集成終端
編程工作區的集成終端在所選工作目錄中運行 shell 命令。它保留連續終端會話,並提供快捷命令、命令歷史與診斷入口。終端輸出和聊天中的工具結果需要分別核對。
運行前確認位置
先選定項目或 worktree,再打開終端。檢查活動終端、所用 shell 與當前目錄。沒有有效工作目錄時,先打開工作區,不從其他項目借用一個終端執行命令。
在執行構建、遷移或清理前,用 pwd(PowerShell 使用 Get-Location)和 git status --short --branch 核對位置。終端的目錄和環境決定命令作用範圍;聊天標題不構成目錄證明。
選擇執行方式
| 入口 | 行為 |
|---|---|
| 交互終端 | 在活動 shell 中輸入命令並查看連續輸出 |
| 快捷命令 | 將所選命令發送到當前工作區的活動終端 |
| 自定義命令 | 在同一個終端會話中執行輸入內容,並記錄命令歷史 |
| 診斷入口 | 生成診斷報告;報告不等於測試或構建結果 |
快捷項包含 git status、npm test、npm run build。它們是執行入口,不代表項目一定使用 npm;先讀倉庫腳本,再選擇對應檢查。
示例:運行項目檢查
打開目標項目的終端,先核對位置,再讀取 package.json 中的 scripts。下面的命令適用於提供 test 和 build 腳本的 npm 項目:
git status --short --branch
npm test
npm run build
逐條執行並檢查結果;測試進入 watch 模式時,按倉庫約定結束 watch 或改用它支持的單次運行參數。不要在前一條命令仍佔用終端時,把後續命令當成已執行。
| 需要確認 | POSIX shell | PowerShell |
|---|---|---|
| 當前目錄 | pwd | Get-Location |
| 上一條外部命令退出碼 | echo $? | $LASTEXITCODE |
| 終止當前前台命令 | Ctrl+C | Ctrl+C |
終端是持續會話,前面執行的 cd、環境變量或虛擬環境會影響後續輸入。快捷命令也發送到這個活動 shell,不會自動創建一個乾淨環境。退出碼應在目標命令結束後立即檢查。
運行開發服務器時,保留對應會話並記錄端口。要在服務器運行期間執行測試,使用另一個終端會話;關閉一個面板不能作為服務器已經停止的證明。
判斷命令是否完成
命令進入終端不等於執行成功。檢查進程是否仍在運行、退出狀態、完整錯誤和預期產物。測試通過後確認測試覆蓋了本次修改;構建成功後確認目標產物存在。
持續服務與一次性命令分別管理。終端顯示輸出停止,不代表後台服務已經退出。中斷前確認該進程屬於當前任務,避免停止其他項目的服務。
歷史、診斷與敏感信息
命令歷史按工作目錄組織,用於找回執行過的輸入,不替代命令結果。清理輸入歷史也不等於清理終端輸出、日誌或外部系統記錄。
不要把 token、完整環境變量或含秘密的連接串直接寫入命令。分享診斷前檢查目錄、賬號、請求內容及日誌中的敏感字段,保留能定位問題的錯誤和時間信息。
常見處理
| 情況 | 操作 |
|---|---|
| 命令作用到錯誤目錄 | 停止後續寫入,確認實際影響,再切回目標工作區 |
| 命令找不到 | 檢查 shell、PATH 和項目安裝要求,不重複安裝無關依賴 |
| 沒有完成狀態 | 檢查活動會話和進程,避免重複啓動同一服務或遷移 |
| 診斷正常但任務失敗 | 回到實際失敗命令的日誌與輸入,分別排查 |
隔離目錄的選擇見Git worktree,差異驗收見代碼審閲與變更處理。