性能问题

本文档帮助你快速诊断和解决 TraeCode 的性能问题，包括 CPU 占用过高、内存泄漏、卡顿卡死、异常耗电等。

快速诊断入口

遇到性能问题时，首先打开进程资源管理器进行诊断：

• 常规入口：点击界面左下角的资源管理器图标，或者点击顶部菜单栏中的 帮助 > 进程浏览器。

• 异常提示入口：当资源使用异常时，界面右下方会显示通知面板，或右上角显示告警图标，点击即可打开。

进程资源管理器

进程资源管理器是诊断性能问题的核心工具，可以实时查看 TraeCode 的资源使用情况。

CPU & 内存监控

在 CPU & 内存 页签中，你可以：

• 分类查看资源使用：按进程类型查看 CPU 和内存占用。
  • 社区插件：用户安装的第三方插件；
  • 用户终端：在 TraeCode 终端中运行的进程；
  • TraeCode 基础服务：TraeCode 本身的核心组件；
  • 其他：难以分类的进程。
• 复制进程信息：选中进程后点击 复制 按钮来获取 JSON 格式的详细信息，用于问题反馈。
• 管理进程：选中进程后可以重启或关闭该进程。

网络状态检查

在 网络 页签中，可以查看：

• 网络连通性状态
• 代理配置信息
• 网络延迟情况

常见问题速查

已知问题插件

以下插件已确认会引起性能问题，建议检查并处理。

建议禁用或卸载

建议降级版本

MCP 相关

语言服务说明

以下语言服务的资源占用与项目规模和使用方式相关，属于正常现象：

• Vite：与项目配置相关
• Tsserver：TypeScript 项目的语言服务
• gopls：Go 语言服务

详细排查指引

CPU 占用过高

排查步骤：

1. 打开进程资源管理器，查看 CPU & 内存 页签。
2. 按 CPU 占用排序，定位高负载进程。
3. 根据进程类型采取措施：
   • 社区插件：对照上文中的已知问题插件列表，禁用或卸载问题插件。
   • TraeCode 基础服务：可能是大文件操作导致，等待操作完成或关闭大文件。
   • 用户终端：检查是否有异常的后台任务，关闭不必要的终端。

内存占用过高

排查步骤：

1. 打开进程资源管理器，观察内存使用趋势。
2. 如果内存持续增长不释放，可能存在内存泄漏。
3. 尝试以下操作：
   • 重启语言服务：使用 Cmd/Ctrl + Shift + P 快捷键，然后输入 restart（如 go: restart）。
   • 重启插件进程：使用 Cmd/Ctrl + Shift + P 快捷键，然后输入 restart ext。
   • 重启 TraeCode：完全退出后重新打开。

TraeCode 卡顿/卡死

快速解决：

1. 排除插件影响：
   1. 打开进程资源管理器。
   2. 点击右上角「禁用插件」按钮。
   3. 完全退出 TraeCode（Cmd+Q 或关闭窗口），重新打开。
2. 减少打开的窗口数量。
3. 升级到最新版本。

如果上述步骤无法解决，请收集进程信息后反馈给技术支持。

异常耗电

当发现电脑耗电速度过快（如放置一晚后电量耗尽），可按以下步骤排查：

macOS 用户排查步骤：

1. 定位耗电进程
   打开活动监视器，然后查看 “能耗” 面板：
   • 若 “对能耗的影响” 或 “12 小时电源” 指标异常高，说明该应用存在能耗问题。
   • 如果耗电异常的应用不是 TraeCode，需根据实际情况处理对应应用。
2. 确认具体进程
   如果是 TraeCode 耗电异常：
   • 在活动监视器中点击 TRAE 左侧的 >，展开子进程列表。
   • 找出能耗异常的具体进程，记录其 PID。
   • 打开 TraeCode 进程资源管理器，对比 PID 确定是哪类进程。
3. 处理问题
   根据问题来源，采取相应措施：
   • 社区插件：考虑禁用、升级或卸载该插件。
   • 用户终端：使用 Cmd+J 打开下面板，找到并关闭耗电的终端。
   • TraeCode 基础服务：升级到最新版本，或反馈给技术支持。

通用建议：升级到最新版本，我们已修复部分场景下产生大量无效请求的问题。

锁屏后白屏/黑屏（macOS）

问题现象：macOS 电脑锁屏后再打开屏幕，TraeCode 窗口显示黑屏或白屏。

问题原因：该问题由上游 Chromium 的 Skia Graphite 模块异常导致，这是 Chromium M134 版本在 macOS 上启用的新渲染架构。

解决方法：

• 方法一：Kill GPU 进程（推荐，无需重启 TraeCode）
  1. 打开活动监视器。
  2. 搜索 Trae CN Helper (GPU)。
  3. 选中该进程后点击左上角的 X 关闭。
  4. 窗口会自动恢复正常。
• 方法二：重启 TraeCode
  1. 使用 Cmd+Q 完全退出 TraeCode。
  2. 重新打开 TraeCode。

系统内存压力警告（macOS）

如果你看到 “系统内存压力过大” 的警告，或者从进程管理器跳转到本页，请阅读以下说明。

以上提示属于 macOS 系统级别的内存压力警告，表示你的 Mac 整体内存资源已接近极限，而非由 TraeCode 本身直接导致。当 TraeCode 检测到系统内存压力升高时，会提前发出提示，帮助你在应用被系统强制关闭之前采取应对措施。

什么是系统内存压力警告？

macOS 采用较为复杂的内存管理机制（内存压缩 + 交换空间 swap）来优化系统性能。当内存压力接近系统阈值时，TraeCode 会提前发出警告，提醒你及时处理，以避免系统因内存不足而强制终止应用。

警告类型：

问题反馈指南

如果通过上述步骤仍无法解决问题，请按以下方式收集信息并反馈。

获取版本基础信息

• Windows
  点击顶部菜单栏中的 帮助 > 关于，然后复制弹窗中 TraeCode 的信息。
  
• macOS
  点击顶部菜单栏中的 TRAE CN > 关于 Trae CN，然后复制弹窗中 TraeCode 的信息。
  

将复制的信息，发给 TRAE 的技术支持。

收集进程信息

1. 打开进程资源管理器。
2. 点击左下角 复制全部 按钮，获取所有进程的 JSON 信息。
3. 将复制的内容保存备用。

打包日志

1. 使用 Cmd/Ctrl + Shift + P 打开命令面板。
2. 输入 open all 搜索，选择 开发人员：Open All Logs Folder。
3. 找到与问题发生时间对应的文件夹。
4. 将文件夹打包成压缩文件。

获取 SessionID（AI 功能问题）

如果是 AI 相关问题，还需要提供 SessionID：

1. 找到出问题的对话。
2. 点击对话左上角的 TRAE 头像。
3. 顶部提示 “Copy Success” 即表示已复制 SessionID。

反馈渠道

点击进程资源管理器右上角的 上报异常 按钮提交问题，并附上：

• 进程信息（JSON）
• 日志压缩包
• SessionID（如适用）
• 问题描述和复现步骤

提供完整的信息可以帮助我们更快定位和解决问题。