以下是一篇关于 Trae 国内版代码编辑工具的详细使用教程：

一、安装与配置

1. 下载与安装

   • 访问 Trae 国内版官网 trae.com.cn，下载适合您操作系统的安装包，目前提供 Mac（macOS 10.15 及以上）和 Windows 版（Windows 10、11），后续还有 Linux 版 。下载完成后，双击安装包按照提示完成安装。
     

   • 首次启动 Trae 国内版时，会进入初始配置页面，点击 “开始” 按钮，进入初始配置流程。选择主题，可选项为暗色、亮色和深蓝，根据个人喜好选择主题颜色；选择显示语言，可选项为简体中文和 English，选择你习惯使用的语言，推荐选择简体中文以便更好地使用 。
     

2. 导入配置

   • 若你的电脑中已安装并配置 VS Code 或 Cursor，你可以选择从 VS Code 或 Cursor 中导入配置或者直接跳过。点击 “从 VS Code 导入” 或 “从 Cursor 导入” 按钮，系统将会从对应的 IDE 中获取插件、IDE 设置、快捷键设置等信息并一键导入到 Trae 中，帮助你快速从其他 IDE 切换到 Trae 。
     

3. 安装命令行

   • 添加 Trae 相关的命令行后，你可以在终端中使用命令行更快速地完成 Trae 相关的操作。点击 “安装 trae 命令” 按钮，然后完成授权流程。安装完成后，你可以在终端中使用以下命令：使用 trae 命令快速唤起 Trae；使用 trae my-react-app 命令在 Trae 中打开一个项目 。
     

4. 登录账号

   • Trae 国内版可通过手机号或第三方社区账号（如掘金社区）注册并登录，与国际版的谷歌授权方式登录不同，国内版和国际版的账户是完全隔离开的 。
     
     

二、核心功能使用

1. Builder 模式

* 启动与项目生成 ：点击界面右上方区域的 “+”> 选择默认配置文件，选择带有 PowerShell{版本号}xxx 字样的配置文件。使用快捷键（macOS：Command + U；Windows：Ctrl + U）打开侧边对话框，在侧边对话框的左上角，点击 Builder，即可进入 Builder 模式。在该模式下，你只需在输入框中用自然语言描述项目需求，例如 “请用 React 生成一个 Todo List 应用”，Trae 会自动分解任务、生成代码框架，甚至优化部署流程 。
* 代码审查与接受 ：根据你的需求，AI 助手会自动创建新文件或编辑已有文件，并自动保存生成的代码。你可以选择接受或拒绝代码变更，处理多文件内的所有代码变更可点击输入框上方待审查文件列表中的 “全部接受” 或 “全部拒绝” 按钮；处理单文件内的所有代码变更可在编辑器内打开文件，点击上方提示条中的接受按钮（快捷键：macOS 为 Command + Enter；Windows 为 Ctrl + Enter）或拒绝按钮（快捷键：macOS 为 Command + Backspace；Windows 为 Ctrl + Backspace）；处理单处代码变更可点击编辑器内某个代码变更右上角的 ^Y 按钮（快捷键：macOS 为 Control+Y；Windows 为 Alt + Y）或 ^N 按钮（快捷键：macOS 为 Control + N；Windows 为 Alt + N） 。

2. Chat 模式
   

   • 启动与交互 ：使用快捷键（macOS：Command + I；Windows：Ctrl + I）打开侧边聊天窗口，即可进入 Chat 模式。在对话框中输入问题或代码需求，Trae 会基于 AI 模型生成代码建议或解答。例如，你可以输入 “如何实现一个轮播图功能”，Trae 会给出相应的代码示例和解释 。
   • 代码更新与应用 ：Trae 会显示原始代码和优化后的代码对比，开发者可以选择接受或拒绝。若接受，可直接在编辑器中查看并应用优化后的代码 。

三、项目管理与操作

1. 打开与创建项目
   • 点击界面左上角的 “文件” 菜单，选择 “打开文件夹” 或 “打开项目”，即可打开本地已有的项目。若要创建新项目，可在该菜单中选择 “新建项目”，然后选择项目类型和存储位置，Trae 会自动生成项目的基本结构 。
   • 在项目文件列表中，双击文件即可在编辑器中打开进行编辑。Trae 提供了强大的代码编辑功能，包括代码高亮、自动补全、语法检查等。在编辑代码时，若需要 AI 助手的帮助，可随时调用 Chat 模式或 Builder 模式 。

四、调试与预览

1. Webview 功能
   • Trae 国内版提供