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

(Windows) 窗口意外終止

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

• （推薦）重啟電腦；

• 關閉安全軟件。

  

(Windows) 花屏

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

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

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

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

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

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

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

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

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

若你遇到以下插件相關問題：

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

嘗試通過以下步驟解決：

1. 在界面右上角，點擊 人像 > 設置，進入 Trae 設置中心。

2. 在 通用 部分的 Editor 設置 處，點擊 去設置 按鈕。

   

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

   

4. 確認該配置項中是否有代理服務地址。
5. 若有地址（如上圖所示），確認該代理服務是否可正常使用。
6. 若代理服務不可用，清空該地址。

7. 關閉 Trae 并重啟。
   插件服務恢復正常。

內(nèi)存占用過高

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

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

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

   

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

   

3. 重啟 Trae：

   • macOS：使用 Command + Q 快捷鍵強制退出 Trae，然后重啟；
   • Windows：在任務欄中關閉 Trae，然后重啟。

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

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

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

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

1. 進入插件市場，檢查是否已安裝了 Python 相關的 LSP 插件。

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

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

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

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

Remote SSH 相關問題

錯誤碼處理：

連接超時問題處理：

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

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

• 日志（從輸出面板復制 Remote-SSH 相關的完整日志）。

  

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

ssh -vvv test


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

輸入過長，導致對話功能異常

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

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

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

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

解決方案如下：

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