Trae问题排查 & 故障修复
本文档记录使用 Trae 时可能遇到的问题并提供解决方法。
(Windows) 窗口意外终止
在 Windows 操作系统中安装或升级 Trae 时，受安全软件影响，有极小概率会遇到 “窗口意外终止” 问题（如下图所示）。如果遇到此情况，可按照以下方式解决：
- （推荐）重启电脑；
-
关闭安全软件。
(Windows) 花屏
如遇到下图所示的花屏现象，可能由于系统开启 GPU 加速导致。
你可以尝试禁用 GPU 加速，步骤如下：
- 使用快捷键 Ctrl + Shift + P 打开命令面板。
- 运行
首选项：配置运行时参数（Preferences: Configure Runtime Arguments）命令。
该命令会打开一个argv.json文件来配置运行时参数。你可能会看到一些默认参数。 - 添加
"disable-hardware-acceleration": true。 - 重启 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) 插件市场展示空数据 / 搜索插件失败 / 使用插件时提示网络错误无法连接
若你遇到以下插件相关问题：
- 打开插件市场后未展示任何数据；
- 搜索插件时提示“搜索插件失败”；
- 编程过程中，无法使用原先可用的插件，并且提示网络错误无法连接。
 |
 |
尝试通过以下步骤解决：
- 在界面右上角，点击 人像 > 设置，进入 Trae 设置中心。
-
在 通用 部分的 Editor 设置 处，点击 去设置 按钮。
-
在 Editor 设置 窗口中，搜索 “Proxy” 并找到 Http: Proxy (适用所有配置文件) 配置项。
- 确认该配置项中是否有代理服务地址。
- 若有地址（如上图所示），确认该代理服务是否可正常使用。
- 若代理服务不可用，清空该地址。
-
关闭 Trae 并重启。
插件服务恢复正常。
内存占用过高
部分社区插件（如 ms.cpp-tools、golang.Go、Kotlin）在使用过程中存在内存泄漏的问题。若遇到内存占用过高的情况，可通过以下步骤尝试解决：
按步骤依次尝试，若当前步骤无法降低内存占用，继续尝试后续步骤，直到重启 Trae。
-
重启语言服务：使用快捷键（macOS：Command + Shift + P；Windows：Ctrl + Shift + P）打开命令输入面板，输入用于重启对应语言服务的命令（如 go: restart）。
-
重启插件进程：在命令输入面板中，输入 restart ext 命令，重启插件进程。
-
重启 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 为例，针对无法跳转到函数定义的问题，可按照以下步骤逐一排查：
-
进入插件市场，检查是否已安装了 Python 相关的 LSP 插件。
-
若已安装了由 ms-python 提供的 Python、Pylance 插件，将其卸载。 在 VS Code 中安装 Python 时一般会自动安装 Pylance，所以从 VS Code 或 Cursor 导入配置到 Trae 后，更容易遇到 LSP 不生效的问题。
-
如无 Python 插件或已将 ms-python 提供的插件卸载干净，请搜索并安装开源社区中 Python 相关的 Language Server，如 BasedPyright。
提示
BasedPyright 默认设置了较为严格的类型检查，为避免被过度干扰，建议将其调低 。步骤如下：
1. 打开 Editor 设置，搜索 pyright type checking mode。
2. 将默认的 recommended 模式修改为 basic 模式。 - 安装 BasedPyright 后，打开任意 Python 文件，鼠标右击任一一处引用的函数，在出现的菜单中可看到 “转到定义” 等菜单项，即说明 LSP 插件正常可用。
Remote SSH 相关问题
错误码处理：
| 错误码 | 错误内容 | 解决方案 |
|---|---|---|
| 1001 | 创建目录失败 | 可能是因为磁盘空间不足或无目录的写入权限。解决方案如下： 检查磁盘剩余空间，确保有足够的空间用于创建目录。 确保有 ~/.trae-cn-server 目录的写入权限。 |
| 1002 | 创建目录失败 | 同 1001 错误码。 |
| 1003 | 远程主机上启动 Trae CN 服务端失败 | 检查远程主机的系统版本是否满足要求。 |
| 2001 | 下载安装包失败 | 检查网络联通性，然后重试。 |
| 2002 | 解压安装包失败 | 可能是由于安装包的下载过程被截断，导致下载的文件异常，重新安装后再尝试解压。 |
| 3001 | 远程主机上启动 Trae CN 服务端失败 | 检查远程主机的系统版本是否满足要求。 |
连接超时问题处理：
| 连接超时原因 | 解决方案 |
|---|---|
| 服务器未启动，或网络无法连接 | 在本地终端执行 ssh <host> 测试远程连接： 若连接失败： 检查远程主机的 Trae CN 服务端是否正常运行。 确认网络连接无异常。 若连接成功：继续排查其他潜在问题。 |
| 远程主机名称包含大写字母 | 部分 Trae CN 客户端版本存在兼容性问题：当 ~/.ssh/config 文件中远程主机名称包含大写字母时，可能导致连接超时。解决方案如下： 升级客户端：将 Trae CN 客户端更新至最新版本。 修改主机名：将配置文件中的主机名称全部改为小写字母。 |
| 不支持服务器的默认 shell | 目前，一些 shell 会导致连接异常，比如 fish。将用户的默认 shell 改成 bash 和 zsh 以解决该问题。 |
| 本地 ~/.ssh/config 文件位置变动 | 如果挪动过本地的 ~/.ssh/config 文件的位置，可能会遇到这个问题。将 ~/.ssh/config 文件放回原先的位置以解决该问题。 |
若以上解决方案仍无法解决你的问题，可以通过《支持》中提供的渠道联系我们。请在问题反馈中提供以下信息，以便我们尽快定位问题并协助你解决:
- IDE 截图（尽量截取完整的 IDE 界面图，以便我们分辨异常信息）。
-
日志（从输出面板复制 Remote-SSH 相关的完整日志）。
- 如果是连接超时问题，附上 ssh -vvv <host> 命令的完整输出结果，我们会根据此信息定位超时的原因。
ssh -vvv test
## 此处会输出大量日志，请复制完整的日志
更多建议：