除錯

開放原始碼帶來實際優勢：程式碼公開可見，你可以在本機執行，並利用 AI 編碼代理加速解答疑問、除錯程式庫中的潛在問題。

若在除錯時發現文件遺漏或不完整，請更新 docs/ 底下的英文文件並提交 PR。

在 CI 上擷取執行緒傾印#

當 CLI 偶爾停滯時，你可以在不停止程序的情況下擷取執行緒傾印。啟用信號處理常式，並向正在執行的 tuist 程序發送 SIGUSR1。

bash

export TUIST_THREAD_DUMP_SIGNAL=1
export TUIST_THREAD_DUMP_SAMPLE=1 # macOS only, captures all threads via /usr/bin/sample
tuist generate &
TUIST_PID=$!
sleep 600
kill -USR1 "$TUIST_PID"
wait "$TUIST_PID"

若未設定 TUIST_THREAD_DUMP_SAMPLE，處理常式會列印目前的執行緒堆疊。輸出會寫入 stderr，因此會出現在 CI 日誌中。

使用 AI 編碼代理#

AI 編碼代理有助於：

掃描程式庫，找出實作特定行為的位置。
在本機重現問題並快速迭代。
追蹤輸入如何流經 Tuist，以找出根本原因。

盡可能分享最小的重現案例，並將代理指向特定元件（CLI、伺服器、快取、文件或手冊）。範圍越聚焦，除錯過程就越快速且準確。

常見提示詞 (FNP)#

專案產生結果不符合預期#

專案產生的結果與預期不符。針對位於 /path/to/project 的專案執行 Tuist CLI，以了解發生此情況的原因。追蹤產生器管線，並指出負責產生該輸出的程式路徑。

已產生專案中的可重現錯誤#

這看起來像是已產生專案中的錯誤。在 examples/ 底下建立一個可重現的專案，並參考現有範例。新增一個會失敗的驗收測試，透過 xcodebuild 僅執行該測試來修復問題，重新執行測試以確認通過，然後開啟 PR。