Trae 是字节跳动推出的一款 AI 原生的集成开发环境（IDE），旨在通过自然语言交互帮你完成从写代码到部署的全流程开发工作。

你可以先通过下面这张图，快速了解它的核心模块与工作流：

flowchart TD
    A[下载与安装 Trae<br>官网: trae.com.cn] --> B[初始配置<br>登录/导入配置/设置主题]

    B --> C{选择工作模式}
    
    C -- 日常编码 --> D[IDE 模式<br>传统开发体验]
    C -- AI 全自动开发 --> E[SOLO 模式<br>AI Agent 主导]
    
    D --> F[核心功能使用]
    E --> F
    
    subgraph F [核心功能使用]
        F1[侧边对话<br>代码生成/解释/测试]
        F2[Cue 智能补全<br>Tab 键接受建议]
        F3[模式切换<br>Chat / Builder / Solo]
        F4[MCP 集成<br>连接外部工具]
    end

    F --> G[完成开发任务]

🚀 第一步：下载、安装与配置

1. 下载：访问 Trae 国内官网 ​​https://www.trae.com.cn/download​​，根据你的操作系统下载对应的安装包。
2. 安装：双击安装包，按提示完成安装。建议勾选“添加到PATH环境变量” 选项，方便后续在终端使用。Trae 支持 Windows 10/11 和 macOS，未来也将支持 Linux。
3. 初始配置：首次启动时，可以选择主题和语言，并可从 VS Code 或 Cursor 导入已有配置。最后，使用手机号或稀土掘金账号登录即可开始使用。

🎯 第二步：熟悉三种核心模式

Trae 提供了三种模式，能帮你高效完成不同层级的开发任务。

简单来说，日常修修补补用 Chat，快速搭建原型用 Builder，处理复杂任务就用 Solo。

✍️ 第三步：掌握核心功能

1. 侧边对话：你的万能工具箱

你可以通过快捷键 ​​Ctrl + U​​ (Windows) 或 ​​Command + U​​ (macOS) 唤起侧边对话面板，并利用以下功能：

• 代码生成：用自然语言描述需求，AI 就会生成代码，你可以选择插入、复制、应用到原文件或创建新文件。
• 代码解释：选中代码后右键选择“Trae AI > 代码解释”，或输入 ​​/explain​​ 指令，AI 就能为你解读。
• 代码编辑与优化：选中代码后，输入“优化这段代码”等指令，AI 会给出修改建议。
• 单元测试生成：选中代码，使用 ​​/test​​ 指令或右键菜单中的“单测生成”，可自动生成测试代码。

2. Cue：懂上下文的智能补全

Cue 是 Trae 的智能代码补全引擎，能根据上下文预测并推荐代码。

• 使用方法：按 ​​Tab​​ 键即可接受 AI 推荐的代码。
• 跳转预测：接受一处修改后，再按 ​​Tab​​ 键，Cue 会智能跳转到下一个可能需要修改的位置。
• 主动触发：使用 ​​Ctrl + Shift + Enter​​ 快捷键可以随时主动唤起代码补全。

🔌 第四步：扩展能力边界

• 模型切换：在 Trae 设置中，你可以在豆包、DeepSeek 等不同 AI 模型间自由切换。
• MCP 集成：通过 Model Context Protocol (MCP) 连接 Figma、GitHub 等外部工具，可以实现从设计稿到代码的自动转换等高级功能，极大扩展 AI 的能力边界。
• 插件扩展：你可以从 Trae 的扩展商店或 VS Code 的市场中安装插件来定制你的开发环境。

🧑‍💻 第五步：试试最佳实践

以下实践技巧能让你的 AI 编程体验更加流畅：

• 清晰表达需求：向 AI 描述任务时，尽量清晰、具体。例如，使用“用 Vue3 + TypeScript 创建一个带表单验证的登录组件”会比“做个登录页面”得到更精准的结果。
• 提供错误信息：遇到报错时，直接将终端报错日志拖拽到对话框中，AI 就能帮你精准定位问题。
• 充分利用 Cue：养成使用 ​​Tab​​ 键的习惯，这能大幅提升编码效率。
• 善用斜杠命令：在对话框中使用 ​​/explain​​、​​/test​​ 等命令，可以快速唤起特定功能。

🤔 第六步：了解 Trae 与 Cursor 的区别

如果你之前了解过 Cursor，这个对比可以帮你更好地理解 Trae 的特点。

• 开发背景与定位：Cursor 由国外团队开发，而 Trae 是字节跳动出品，对中文开发者社区的支持和国内使用环境更加友好。
• 模型与付费：Trae 国内版默认搭载豆包和 DeepSeek 等模型，且基础功能完全免费，Solo 等高级功能需订阅。Cursor 则集成 GPT-4o、Claude 等国外模型，主要采用付费订阅制。
• 插件兼容性：两者都基于 VS Code 内核，兼容大部分 VS Code 插件，但在 Remote SSH、Pylance 等特定插件上可能存在差异。
• 性能表现：在复杂逻辑和深度代码理解任务上，Cursor 的表现可能更优。而 Trae 在中文交互、平台易用性和性价比方面更具优势。

❓ 第七步：常见问题排查

• 启动时提示“权限不足”：在 Windows 上，可以右键选择“以管理员身份运行”来启动 Trae。
• 代码补全响应慢：尝试使用 ​​Ctrl+Shift+R​​ 快捷键重置智能缓存。
• MCP 连接失败：检查 MCP 的配置格式是否正确，并尝试重启 Trae 应用。
• AI 生成的代码有错误：可以将报错信息直接发给 AI 寻求修复，或利用 ​​trae verify​​ 命令进行静态分析。

💎 第八步：持续学习和获取资源

• 官方文档：访问 ​​TRAE CN 官方文档​​ 获取最权威的信息。
• 中文教程：​​W3Cschool上的Trae教程​​ 提供了一个系统性的学习路径。
• 实战文章：在技术社区搜索“Trae 实战”或“Trae 教程”，可以找到许多具体的项目案例，如开发贪吃蛇游戏、语音生成应用等。

祝你使用愉快！如果想了解某个具体功能的详细用法，也可以随时来问我。