Trae问题排查 & 故障修复

本文档记录使用 Trae 时可能遇到的问题并提供解决方法。

(Windows) 窗口意外终止

在 Windows 操作系统中安装或升级 Trae 时，受安全软件影响，有极小概率会遇到 “窗口意外终止” 问题（如下图所示）。如果遇到此情况，可按照以下方式解决：

• （推荐）重启电脑；

• 关闭安全软件。

  

(Windows) 花屏

如遇到下图所示的花屏现象，可能由于系统开启 GPU 加速导致。

你可以尝试禁用 GPU 加速，步骤如下：

1. 使用快捷键 Ctrl + Shift + P 打开命令面板。
2. 运行 首选项：配置运行时参数（Preferences: Configure Runtime Arguments）命令。
   该命令会打开一个 argv.json 文件来配置运行时参数。你可能会看到一些默认参数。
3. 添加 "disable-hardware-acceleration": true。
4. 重启 Trae。

(Windows) “Access is Denied. (os error5)” 错误

在 Trae 中点击 “自动更新” 后，若桌面图标无法打开，且提示 “Access is Denied.(os error5)” 错误（下图所示），你可以通过以下方式解决：无需卸载原先安装的 Trae，直接从 Trae 官网重新下载 Windows 版的安装包并完成安装，你原有的代码、插件及 IDE 配置信息等数据都会被保留。

(Windows) Chat/Builder 模式提示 “客户端异常，请稍后重试”

如果 Chat/Builder 模式提示 ”客户端异常，请稍后重试“，可以尝试以下解决方法：

• 方法一：检查电脑中是否安装了 Astrill VPN。如果已安装，请卸载该应用并重启电脑，之后再重新启动 Trae。
• 方法二：如果系统缺少必要的文件，也可能导致该错误。请下载并安装 Microsoft Visual C++ 2015 - 2022 Redistributable，然后重新启动 Trae。

(Windows) 插件市场展示空数据 / 搜索插件失败 / 使用插件时提示网络错误无法连接

若你遇到以下插件相关问题：

• 打开插件市场后未展示任何数据；
• 搜索插件时提示“搜索插件失败”；
• 编程过程中，无法使用原先可用的插件，并且提示网络错误无法连接。

尝试通过以下步骤解决：

1. 在界面右上角，点击 人像 > 设置，进入 Trae 设置中心。

2. 在 通用 部分的 Editor 设置 处，点击 去设置 按钮。

   

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

   

4. 确认该配置项中是否有代理服务地址。
5. 若有地址（如上图所示），确认该代理服务是否可正常使用。
6. 若代理服务不可用，清空该地址。

7. 关闭 Trae 并重启。
   插件服务恢复正常。

内存占用过高

部分社区插件（如 ms.cpp-tools、golang.Go、Kotlin）在使用过程中存在内存泄漏的问题。若遇到内存占用过高的情况，可通过以下步骤尝试解决：

按步骤依次尝试，若当前步骤无法降低内存占用，继续尝试后续步骤，直到重启 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 + 鼠标左键” 跳转到函数定义

语法检测、跳转函数定义等类似的功能是由该语言对应的 Language Server Provider（简称 LSP）提供。以 Python 为例，如遇到了 Python 文件里无法通过快捷键跳转到函数定义，可能的原因有以下几种：

• IDE 中未安装 Python 相关的 LSP 插件，如 Python、Pylance、Pyright 等。
• Python 相关的 LSP 插件由于某些原因（如仓库过大等）未能加载成功。
• 受限于插件开发者的服务条款限制，Python 相关的 LSP 插件只能在特定产品中使用，如由 Microsoft 开发的 Python 插件明确提出只能在 VS Code 中使用。

同样以 Python 为例，针对无法跳转到函数定义的问题，可按照以下步骤逐一排查：

1. 进入插件市场，检查是否已安装了 Python 相关的 LSP 插件。

2. 若已安装了由 ms-python 提供的 Python、Pylance 插件，将其卸载。 在 VS Code 中安装 Python 时一般会自动安装 Pylance，所以从 VS Code 或 Cursor 导入配置到 Trae 后，更容易遇到 LSP 不生效的问题。

3. 如无 Python 插件或已将 ms-python 提供的插件卸载干净，请搜索并安装开源社区中 Python 相关的 Language Server，如 BasedPyright。

   提示
   BasedPyright 默认设置了较为严格的类型检查，为避免被过度干扰，建议将其调低 。步骤如下：
   1. 打开 Editor 设置，搜索 pyright type checking mode。
   2. 将默认的 recommended 模式修改为 basic 模式。

4. 安装 BasedPyright 后，打开任意 Python 文件，鼠标右击任一一处引用的函数，在出现的菜单中可看到 “转到定义” 等菜单项，即说明 LSP 插件正常可用。

Remote SSH 相关问题

错误码处理：

连接超时问题处理：

若以上解决方案仍无法解决你的问题，可以通过《支持》中提供的渠道联系我们。请在问题反馈中提供以下信息，以便我们尽快定位问题并协助你解决:

• IDE 截图（尽量截取完整的 IDE 界面图，以便我们分辨异常信息）。

• 日志（从输出面板复制 Remote-SSH 相关的完整日志）。

  

• 如果是连接超时问题，附上 ssh -vvv <host> 命令的完整输出结果，我们会根据此信息定位超时的原因。

ssh -vvv test


## 此处会输出大量日志，请复制完整的日志

输入过长，导致对话功能异常

与 AI 助手对话时，系统会综合计算以下内容的长度总和，作为输入长度：

• 输入框中的发送内容
• 自定义智能体的提示词
• 自定义智能体所使用的 MCP Server 中包含的所有工具
• 个人规则和项目规则

当总长度超出限制时，可能会出现：

• 系统报错导致对话功能异常（如无法发送问题）
• 问答效果下降

解决方案如下：

• 精简提问内容、智能体的提示词、MCP Server 中包含的工具数量、以及个人规则和项目规则
• 尝试切换其他模型

打开 AI 对话框后，提示 ”服务启动异常“

打开 AI 对话框后，若界面上提示 “服务启动异常“，可尝试通过以下方法解决：

快捷键失效

该问题一般由快捷键设置冲突导致，即为多个命令注册了同一个快捷键。尝试以下步骤进行解决：

1. 使用 Command/Ctrl + Shift + P 快捷键打开命令面板，查找 开发人员：切换键盘快捷键疑难解答 命令并点击。

   

   IDE 底部显示 输出 面板，用于展示快捷键操作的相关信息。

2. 在 IDE 中是使用快捷键。

   输出 面板中展示该快捷键相关的命令信息。

3. 复制快捷键当前所激活的命令的 ID。

   

4. 先后使用 Command/Ctrl + K 和 Command/Ctrl + S 快捷键打开 键盘快捷键 窗口。

5. 在输入框中输入所复制的命令的 ID。

   窗口中展示命令名称以及所绑定的快捷键。

6. 点击命令名称左侧的 修改 图标，修改该命令所绑定的快捷键。

   

   此外，也有可能是因为你在 Trae IDE 内导入了来自其他 IDE 的快捷键配置，从而导致快捷键冲突问题。你可以点击下图所示的图标打开 keybindings.json 文件，然后删除不需要快捷键配置。

打开新的文件后，先前打开的文件标签页自动关闭

该问题由 Preview 模式导致。若无需使用该模式，使用以下步骤将其关闭：

1. 前往 IDE 设置中心。
2. 在 通用 设置面板的 Editor 设置 部分，点击 去设置 按钮。
3. 在输入框中输入关键词 “Preview”。

4. 在结果列表中找到 Workbench > Editor: Enable Preview 设置，然后将其关闭。

   

   Python 相关

Python 无法通过 “Command/Ctrl + 鼠标左键” 跳转到函数定义

语法检测、跳转函数定义等类似的功能是由该语言对应的 Language Server Provider（简称 LSP）提供。以 Python 为例，如遇到了 Python 文件里无法通过快捷键跳转到函数定义，可能的原因有以下几种：

• Trae CN 中未安装 Python 相关的 LSP 插件，如 Python、Pylance、Pyright 等。
• Python 相关的 LSP 插件由于某些原因（如仓库过大等）未能加载成功。
• 受限于插件开发者的服务条款限制，Python 相关的 LSP 插件只能在特定产品中使用，如由 Microsoft 开发的 Python 插件明确提出只能在 VS Code 中使用。

同样以 Python 为例，针对无法跳转到函数定义的问题，可按照以下步骤逐一排查：

1. 进入插件市场，检查是否已安装了 Python 相关的 LSP 插件。

   

2. 若已安装了由 ms-python 提供的 Python、Pylance 插件，将其卸载。

   提示
   在 VS Code 中安装 Python 时一般会自动安装 Pylance，所以从 VS Code 或 Cursor 导入配置到 Trae CN 后，更容易遇到 LSP 不生效的问题。

   

3. 如无 Python 插件或已将 ms-python 提供的插件卸载干净，请搜索并安装开源社区中 Python 相关的 Language Server，如 BasedPyright。

   

   提示
   BasedPyright 默认设置了较为严格的类型检查，为避免被过度干扰，建议将其调低 。步骤如下：
   1.打开 Editor 设置，搜索 pyright type checking mode。
   2.将默认的 recommended 模式修改为 basic 模式。

4. 安装 BasedPyright 后，打开任意 Python 文件，鼠标右击任一一处引用的函数，在出现的菜单中可看到 “转到定义” 等菜单项，即说明 LSP 插件正常可用。

   

Python 代码中，使用 F2 键修改变量名会使每一行后都添加空行

微软的 Python 插件自带了语言服务 Jedi，无需使用它。前往插件市场，然后安装 BasedPyright 插件进行使用。

无法使用代码跳转功能

参考以下解决方法：

• Python 插件 2025.6.1 版本在某些项目上会报错，你可以安装 BasedPyright 插件作为替代。
• 检查 Python 语言服务插件，如 BasedPyright 插件是否被禁用。若被禁用，需将其开启。

• 检查 Python 语言服务是否崩溃。若奔溃，使用 Command/Ctrl + Shift + P 快捷键打开命令面板，然后使用 Python：重启语言服务器 命令来重启 LSP。

  

语法高亮功能失效

打开插件市场，然后找到 Python 插件。若插件的状态如下图所示，需卸载后再重新安装。

Go 相关

安装 gopls 时出现如下报错: go/pkg/sumdb/sum.golang.org/latest: no such file or directory

检查当前用户是否有 ~/go 目录的写入权限。如果没有该权限，可以使用以下命令修改权限：

sudo chmod -R 777 ~/go

Go 1.17 版本无法使用语言服务

Trae IDE 会根据用户当前使用的 Go 版本自动安装对应的 gopls 二进制文件。但如果你使用的是 Go 1.17，Trae IDE 无法通过 go 命令正确识别该版本的 gopls 二进制文件，因此可能会导致无法使用语言服务。此时，先手动删除已安装的 gopls 二进制文件、dlv 文件和 staticcheck 文件，然后重启 Trae ID。

rm ~/go/bin/gopls // 删除 /go/bin 目录中的 gopls 文件
rm ~/go/bin/dlv // 删除 /go/bin 目录中的 dlv 文件
rm ~/go/bin/staticcheck // 删除 /go/bin 目录中的 staticcheck 文件

go.mod 文件报错 “"{{context.GOARCH}} {{context.Compiler}}": invalid char '{'”

使用以下步骤来解决该问题：

1. 使用 Command/Ctrl + Shift + P 快捷键打开命令面板，点击 首选项：打开用户设置（JSON） 选项来打开 settings.json 文件，然后检查该文件中是否存在 go.buildFlags 配置。若有，删除该配置。

   

2. 若步骤一无法解决问题，使用 Command/Ctrl + Shift + P 快捷键打开命令面板，然后使用 Go：Install/Update Tools 命令来重装 Go Tools。

   

无法在代码间跳转

若无法在代码间跳转，任何函数和类都显示正在加载中，且重启 Trae IDE 无法解决该问题，尝试以下步骤：

1. 打开终端，执行 go env 命令，检查是否配置了内网的 GOPROXY。如果没有配置内网代理，将无法拉取 Go 依赖，导致代码分析和跳转功能异常。

   下图中为未配置内网 GOPROXY 的示例：

   

2. 如果未配置内网的 GOPROXY，请根据公司或网络环境，正确设置内网的 GOPROXY。
3. 配置完成后，重新启动 Trae IDE。

Java 相关

无法识别 Lombok 注解的类的方法

你可能在 IDE 中安装了多个 Java 插件，其中某些插件无法正确识别 Lombok，导致编辑器中出现错误提示。而 Red Hat Java 插件能够正常识别 Lombok，支持代码跳转等功能。

你需要卸载无法正确支持 Lombok 的 Java 插件（例如 Java Language Support），只保留 Red Hat Java 插件。

TypeSccript 相关

TypeScript 语言服务无法使用

使用以下步骤解决该问题：

• 检查 TypeScript 插件是否被禁用。若被禁用，将其启用。

• 若 TypeScript 插件未被禁用，则需要重启 TypeScript 的语言服务：

  a. 使用 Command/Ctrl + Shift + P 快捷键打开命令面板。 b. 使用 TypeScript：重启 TS 服务器 命令。

  

无法找到需 import 的模块

检查项目是否已初始化、node_modules 是否已安装。

C/C++ 相关

无法识别 #include 指令、跳转功能失效

尝试以下步骤来解决该问题：

1. 检查是否同时安装了 clangd 和 Microsoft C/C++ 插件。这两个插件不能同时安装，否则会冲突，导致跳转等功能异常。
2. 如果同时安装上述两个插件，卸载其中一个。建议保留你平时主要使用的插件。
3. 重启 Trae IDE。

配置 C++ 远程调试时，报错 “配置的类型‘cppdbg’不受支持”

该错误通常是因为远程环境未安装必需的 C/C++ 插件。确保在远程机器（或远程开发环境）中安装了 Microsoft 的 C/C++ 插件（通常名称为 ms-vscode.cpptools），以支持 cppdbg 调试类型。

安装完成后，重启远程环境，再次尝试调试。

Vue 相关

Vue 文件未高亮，无法跳转

需要安装 Vue - Official 插件实现 Vue 的语法高亮以及语言服务。你可以通过以下两种方式安装：

• 打开 .vue 文件时，IDE 界面右下角会提醒安装 Vue - Official 插件，可以点击安装。
• 在插件市场搜索 Vue - Official，安装该插件。

Vue 服务器短时间内多次崩溃，无法重启

若出现 “The Vue server crashed 5 times in the last 3 minutes. The server will not be restarted. See the output for more information“ 错误，检查是否安装了3.0.0-alpha.6 版本的 Vue - Official 插件。若是，卸载该版本，然后安装其他版本。

行注释功能失效

若行注释功能（macOS： command + /；Windows：ctrl + /）失效，一般是因为 Vue 的语言服务已崩溃，使用以下步骤重启：

1. 使用 Command/Ctrl + Shift + P 快捷键打开命令面板。

2. 使用 Vue：Restart Vue and TS servers 命令重启 Vue 的语言服务。

   

代码折叠失效

若代码折叠失效，一般是因为 Vue 的语言服务已崩溃，使用以下步骤重启：

1. 使用 Command/Ctrl + Shift + P 快捷键打开命令面板。

2. 选择 Vue：Restart Vue and TS servers 命令。

   

终端相关

(Windows) 无法运行 .bat 文件

执行方式不对。若使用以下命令行运行 .bat 文件则会报错：

test.bat

需要在命令行前添加 ./：

./test.bat

外部环境变量未生效

外部环境变量需要自行在 ~/.bashrc 等配置文件里注入。

• macOS/Linux：打开 ~/.bashrc 文件，然后添加 export MY_ENV=1234。
• Windows：在终端中输入 trae $PROFILE，然后在打开的配置文件中添加 $env:MY_ENV="1234"。

(Windows) 使用 Conda 切换 Python 虚拟环境不生效

Windows 系统中，Conda 自带 Conda Prompt CLI，相当于全新启动的进程，有特定的 conda_hook 注入。

内部终端会直接复用已有终端，在没有 conda_hook 注入的情况下，不会正常工作。需要在 Trae IDE 的 PowerShell 终端内，先执行以下脚本注入 conda_hook，然后可正常使用 Conda。

& 'C:\app\miniconda3\shell\condabin\conda-hook.ps1' ; conda activate 'C:\app\miniconda3'

登录相关

(Windows) 点击 “登录“ 按钮后无反应

尝试重新配置默认浏览器：

1. 前往 设置 > 应用 > 默认应用。

2. 设置默认浏览器（推荐 Google Chrome）。

   

(Windows) 登录时总是显示 “127.0.0.1 无法访问”

尝试以下解决方法：

• 关闭防火墙。

• 前往 设置 > 隐私与安全 > Windows 安全 > 防火墙和网络保护 > 高级设置，检查入站规则中是否有拦截 127.0.0.1 的规则，有的话将其关闭。