本文檔記錄使用 Trae 時可能遇到的問題并提供解決方法。

(Windows) 窗口意外終止

在 Windows 操作系統(tǒng)中安裝或升級 Trae 時，受安全軟件影響，有極小概率會遇到 “窗口意外終止” 問題（如下圖所示）。如果遇到此情況，可按照以下方式解決：

• （推薦）重啟電腦；

• 關(guān)閉安全軟件。

  

(Windows) 花屏

如遇到下圖所示的花屏現(xiàn)象，可能由于系統(tǒng)開啟 GPU 加速導(dǎo)致。

你可以嘗試禁用 GPU 加速，步驟如下：

1. 使用快捷鍵 Ctrl + Shift + P 打開命令面板。
2. 運(yùn)行 首選項(xiàng)：配置運(yùn)行時參數(shù)（Preferences: Configure Runtime Arguments）命令。
   該命令會打開一個 argv.json 文件來配置運(yùn)行時參數(shù)。你可能會看到一些默認(rèn)參數(shù)。
3. 添加 "disable-hardware-acceleration": true。
4. 重啟 Trae。

(Windows) “Access is Denied. (os error5)” 錯誤

在 Trae 中點(diǎn)擊 “自動更新” 后，若桌面圖標(biāo)無法打開，且提示 “Access is Denied.(os error5)” 錯誤（下圖所示），你可以通過以下方式解決：無需卸載原先安裝的 Trae，直接從 Trae 官網(wǎng)重新下載 Windows 版的安裝包并完成安裝，你原有的代碼、插件及 IDE 配置信息等數(shù)據(jù)都會被保留。

(Windows) Chat/Builder 模式提示 “客戶端異常，請稍后重試”

如果 Chat/Builder 模式提示 ”客戶端異常，請稍后重試“，可以嘗試以下解決方法：

• 方法一：檢查電腦中是否安裝了 Astrill VPN。如果已安裝，請卸載該應(yīng)用并重啟電腦，之后再重新啟動 Trae。
• 方法二：如果系統(tǒng)缺少必要的文件，也可能導(dǎo)致該錯誤。請下載并安裝 Microsoft Visual C++ 2015 - 2022 Redistributable，然后重新啟動 Trae。

(Windows) 插件市場展示空數(shù)據(jù) / 搜索插件失敗 / 使用插件時提示網(wǎng)絡(luò)錯誤無法連接

若你遇到以下插件相關(guān)問題：

• 打開插件市場后未展示任何數(shù)據(jù)；
• 搜索插件時提示“搜索插件失敗”；
• 編程過程中，無法使用原先可用的插件，并且提示網(wǎng)絡(luò)錯誤無法連接。

嘗試通過以下步驟解決：

1. 在界面右上角，點(diǎn)擊 人像 > 設(shè)置，進(jìn)入 Trae 設(shè)置中心。

2. 在 通用 部分的 Editor 設(shè)置 處，點(diǎn)擊 去設(shè)置 按鈕。

   

3. 在 Editor 設(shè)置 窗口中，搜索 “Proxy” 并找到 Http: Proxy (適用所有配置文件) 配置項(xiàng)。

   

4. 確認(rèn)該配置項(xiàng)中是否有代理服務(wù)地址。
5. 若有地址（如上圖所示），確認(rèn)該代理服務(wù)是否可正常使用。
6. 若代理服務(wù)不可用，清空該地址。

7. 關(guān)閉 Trae 并重啟。
   插件服務(wù)恢復(fù)正常。

內(nèi)存占用過高

部分社區(qū)插件（如 ms.cpp-tools、golang.Go、Kotlin）在使用過程中存在內(nèi)存泄漏的問題。若遇到內(nèi)存占用過高的情況，可通過以下步驟嘗試解決：

按步驟依次嘗試，若當(dāng)前步驟無法降低內(nèi)存占用，繼續(xù)嘗試后續(xù)步驟，直到重啟 Trae。

1. 重啟語言服務(wù)：使用快捷鍵（macOS：Command + Shift + P；Windows：Ctrl + Shift + P）打開命令輸入面板，輸入用于重啟對應(yīng)語言服務(wù)的命令（如 go: restart）。

   

2. 重啟插件進(jìn)程：在命令輸入面板中，輸入 restart ext 命令，重啟插件進(jìn)程。

   

3. 重啟 Trae：

   • macOS：使用 Command + Q 快捷鍵強(qiáng)制退出 Trae，然后重啟；
   • Windows：在任務(wù)欄中關(guān)閉 Trae，然后重啟。

Python 無法通過 “Command/Ctrl + 鼠標(biāo)左鍵” 跳轉(zhuǎn)到函數(shù)定義

語法檢測、跳轉(zhuǎn)函數(shù)定義等類似的功能是由該語言對應(yīng)的 Language Server Provider（簡稱 LSP）提供。以 Python 為例，如遇到了 Python 文件里無法通過快捷鍵跳轉(zhuǎn)到函數(shù)定義，可能的原因有以下幾種：

• IDE 中未安裝 Python 相關(guān)的 LSP 插件，如 Python、Pylance、Pyright 等。
• Python 相關(guān)的 LSP 插件由于某些原因（如倉庫過大等）未能加載成功。
• 受限于插件開發(fā)者的服務(wù)條款限制，Python 相關(guān)的 LSP 插件只能在特定產(chǎn)品中使用，如由 Microsoft 開發(fā)的 Python 插件明確提出只能在 VS Code 中使用。

同樣以 Python 為例，針對無法跳轉(zhuǎn)到函數(shù)定義的問題，可按照以下步驟逐一排查：

1. 進(jìn)入插件市場，檢查是否已安裝了 Python 相關(guān)的 LSP 插件。

2. 若已安裝了由 ms-python 提供的 Python、Pylance 插件，將其卸載。 在 VS Code 中安裝 Python 時一般會自動安裝 Pylance，所以從 VS Code 或 Cursor 導(dǎo)入配置到 Trae 后，更容易遇到 LSP 不生效的問題。

3. 如無 Python 插件或已將 ms-python 提供的插件卸載干凈，請搜索并安裝開源社區(qū)中 Python 相關(guān)的 Language Server，如 BasedPyright。

   提示
   BasedPyright 默認(rèn)設(shè)置了較為嚴(yán)格的類型檢查，為避免被過度干擾，建議將其調(diào)低 。步驟如下：
   1. 打開 Editor 設(shè)置，搜索 pyright type checking mode。
   2. 將默認(rèn)的 recommended 模式修改為 basic 模式。

4. 安裝 BasedPyright 后，打開任意 Python 文件，鼠標(biāo)右擊任一一處引用的函數(shù)，在出現(xiàn)的菜單中可看到 “轉(zhuǎn)到定義” 等菜單項(xiàng)，即說明 LSP 插件正?？捎谩?

Remote SSH 相關(guān)問題

錯誤碼處理：

連接超時問題處理：

若以上解決方案仍無法解決你的問題，可以通過《支持》中提供的渠道聯(lián)系我們。請?jiān)趩栴}反饋中提供以下信息，以便我們盡快定位問題并協(xié)助你解決:

• IDE 截圖（盡量截取完整的 IDE 界面圖，以便我們分辨異常信息）。

• 日志（從輸出面板復(fù)制 Remote-SSH 相關(guān)的完整日志）。

  

• 如果是連接超時問題，附上 ssh -vvv <host> 命令的完整輸出結(jié)果，我們會根據(jù)此信息定位超時的原因。

ssh -vvv test


## 此處會輸出大量日志，請復(fù)制完整的日志

輸入過長，導(dǎo)致對話功能異常

與 AI 助手對話時，系統(tǒng)會綜合計算以下內(nèi)容的長度總和，作為輸入長度：

• 輸入框中的發(fā)送內(nèi)容
• 自定義智能體的提示詞
• 自定義智能體所使用的 MCP Server 中包含的所有工具
• 個人規(guī)則和項(xiàng)目規(guī)則

當(dāng)總長度超出限制時，可能會出現(xiàn)：

• 系統(tǒng)報錯導(dǎo)致對話功能異常（如無法發(fā)送問題）
• 問答效果下降

解決方案如下：

• 精簡提問內(nèi)容、智能體的提示詞、MCP Server 中包含的工具數(shù)量、以及個人規(guī)則和項(xiàng)目規(guī)則
• 嘗試切換其他模型