Trae AI 安装与使用指南

为方便在终端中使用 Trae：

1. 点击'安装 trae 命令'按钮
2. 完成授权流程
3. 安装后可在终端使用以下命令：
   • trae：快速唤起 Trae
   • trae my-react-app：在 Trae 中打开指定项目

4. 登录账号

使用 Trae AI 功能需要登录账号：

1. 点击'登录'按钮
2. 国内版支持手机号、掘金账号登录
3. 国际版支持 GitHub、Google 账号登录
4. 登录成功后即可使用 AI 功能

注意：国际版登录可能需要配置网络代理

三、Trae AI 核心功能与使用教程

Trae AI 主要提供两种工作模式：Chat 模式和 Builder 模式，分别适用于不同的开发场景。

1. Chat 模式：智能问答与代码辅助

进入方式：

• 默认启动即为 Chat 模式
• 或使用快捷键 Command/Ctrl + U 打开侧边对话框，然后点击左上角的'Chat'

功能特点：

1. 代码解释：选中代码后右键选择'Ask Trae'，AI 会解释代码逻辑
2. 错误修复：将终端报错信息拖拽到对话框，AI 提供修复方案
3. 代码优化：输入优化需求，如'优化这段 Python 代码的运行效率'
4. 技术问答：直接提问技术问题，如'如何在 React 中使用 Redux'

模型选择：

• 国内版：Doubao-1.5-pro（默认）、DeepSeek-R1、DeepSeek-V3
• 国际版：Claude 3.5、GPT-4o

使用案例：

1. 选中一段有问题的代码，右键点击'Ask Trae'
2. 输入问题：'为什么这段代码会报错？如何修复？'
3. AI 会分析代码并给出解释和修复建议
4. 点击'应用'将修改应用到代码中

2. Builder 模式：从零构建项目

进入方式：

1. 使用快捷键 Command/Ctrl + U 打开侧边对话框
2. 点击左上角的'Builder'
3. 点击'启用 Builder'按钮
4. 选择 AI 模型（DeepSeek-R1 或 DeepSeek-V3）

功能特点：

1. 自然语言生成项目：用中文描述需求即可生成完整项目
2. 自动环境配置：自动安装依赖、初始化项目
3. 多文件协调：同时生成/修改多个关联文件
4. 实时预览：一键预览 Web 页面效果

使用流程：

1. 新建项目：
   • 点击'文件 → 新建项目 → AI 驱动开发'
   • 或新建文件夹后，在 Builder 模式输入需求
2. 输入需求：
   用自然语言描述项目，例如：
   • '开发一个包含登录功能的待办事项 App'
   • '使用 Vue 开发一个网页抽奖程序，界面简洁'
3. 项目生成：
   • AI 会自动生成功能清单
   • 确认后生成项目结构、安装依赖
4. 处理代码变更：
   • 多文件变更：点击'全部接受'或'全部拒绝'批量处理
   • 单文件变更：在编辑器中点击'接受'(Cmd/Ctrl+Enter) 或'拒绝'(Cmd/Ctrl+Backspace)
   • 单处变更：点击代码右上角的 ^Y(接受) 或 ^N(拒绝)
5. 运行与预览：
   • 点击'运行'按钮启动项目
   • 点击'预览'在 Webview 中查看效果
   • 点击'在浏览器中打开'可全屏预览

示例输出：

- 前端：Vue3 + Element Plus - 后端：Node.js + Express - 数据库：MongoDB 配置 

3. 高级功能与技巧

上下文引用

通过 # 符号添加各类上下文：

• #Code：引用函数/类代码
• #File：引用整个文件内容
• #Folder：引用文件夹所有内容
• #Workspace：引用整个工作空间

多模态输入

• 上传图片（如设计稿、报错截图），AI 会根据图片生成代码或解决问题
• 示例：上传 Axure 原型图，输入'生成对应的 React 组件'

代码自动补全

• 在光标位置按回车，AI 会根据上下文自动补全代码
• 输入中文注释如'计算本月工资总额'，按 Tab 自动补全函数

版本回退

• 在 Builder 模式中，点击对话历史中的'回退'按钮可恢复到之前版本
• 支持回退最近 10 轮会话内的版本

四、Trae AI 调试与问题解决

1. 常见问题解决方案

安装问题

• 登录失败：国际版可能需要配置网络代理

依赖安装失败：可改用国内镜像源，如：

npm config set registry https://registry.npmmirror.com pip install PyQt6 -i https://pypi.tuna.tsinghua.edu.cn/simple/ 

代码生成问题

• 不符合预期：优化提示词，使用更具体描述
  示例：
  • 不佳：'添加登录功能'
  • 优化：'使用 JWT 实现用户登录，有效期 7 天'
• 进入 Bug 循环：回到最初，把所有功能加入初始需求重新生成

运行报错

1. 复制报错信息到 Chat 模式
2. 或直接输入：'当前程序出错，检查 [文件名] 错误'
3. AI 会分析并提供修复方案

2. 调试技巧

1. 终端联动调试：
   • 直接拖拽终端日志到对话区
   • 输入'解释这 3 行报错'，AI 会标注问题代码行
2. 分步验证：
   • 对复杂功能，分多个小步骤让 AI 实现
   • 每完成一步进行验证
3. 对比差异：
   • 使用 Cmd/Ctrl + Shift + D 对比 AI 生成代码与手动修改的差异
4. 环境检查：
   • 在 Chat 模式输入'检查当前项目环境缺少哪些依赖'
   • AI 会列出缺失依赖及安装命令

3. 性能优化建议

1. 硬件配置：
   • 内存不足时可关闭不必要的插件
   • 大型项目建议使用 16GB 以上内存
2. 网络优化：
   • 国际版用户建议使用稳定的网络代理连接
   • 国内版用户如遇延迟可尝试切换 DeepSeek-R1 模型
3. 项目设置：
   • 大型项目可拆分为多个子项目
   • 使用 #Folder 而非 #Workspace 减少上下文负载

五、实战案例演示

案例 1：创建 React 项目并修改样式

1. 创建项目：
   • Builder 模式输入：'创建一个 React 项目，使用 Vite 构建'
2. 修改样式：
   • 输入：'将按钮背景色改为蓝色'
   • AI 会显示修改内容，绿色表示新增
   • 点击'Accept'应用更改
3. 添加功能：
   • 输入：'点击按钮后显示对话框弹窗'
   • AI 会修改代码添加弹窗组件
   • 测试功能并进一步优化

AI 生成项目后，运行：

npm install && npm run dev

案例 2：开发抽奖程序（Builder 模式）

1. 初始需求：
   • 输入：'帮我生成一个基于网页的抽奖程序，要求采用 Vue 开发，界面简洁'
2. 功能迭代：
   • '增加进度条显示答题进度'
   • '每答对一题让灯笼变亮'
   • '答完后灯笼起飞动画'
   • '增加 100 道题目，每次随机抽取 10 题'
3. 最终效果：
   • 完整可运行的抽奖网页
   • 包含美观的 UI 和流畅交互

案例 3：调试 Python 项目

1. 报错分析：
   • 将报错信息拖到 Chat 模式：'ModuleNotFoundError: No module named 'pymysql''
2. 解决方案：
   • AI 建议安装 pymysql 并修改 requirements.txt
   • 或提供国内镜像安装命令
3. 预防措施：
   • 输入：'如何避免 Python 项目中的依赖问题？'
   • AI 会建议使用虚拟环境等最佳实践

六、Trae AI 使用最佳实践

1. 提示词优化技巧

• 具体明确：
  • 不佳：'写一个登录功能'
  • 优化：'用 React 实现一个登录表单，包含邮箱和密码输入框，使用 Material-UI 样式，提交时调用/auth/login API'

提供示例：
'类似以下代码的结构，但改用 TypeScript 实现：

function Counter() {
  const [count, setCount] = useState(0);
  // ...
}

'

分步指示：

1. 首先创建一个 React 函数组件
2. 添加两个受控输入框
3. 实现表单验证逻辑
4. 添加提交按钮和 API 调用

2. 项目协作建议

• 共享会话上下文：
  • 导出 AI 交互记录为 trea-session.json 供团队成员复用
• 代码审查：
  • 使用 Cmd/Ctrl + Shift + D 对比 AI 生成代码
  • 对关键功能进行手动测试
• 文档生成：
  • 输入：'为这个项目生成 README 文件，包含安装步骤和 API 文档'
  • AI 会生成结构化文档

3. 学习资源推荐

1. 官方资源：
   • Trae 官网文档：https://docs.trae.ai/docs/set-up-trae
2. 进阶技巧：
   • 多模态开发（语音输入、视频交互）
   • 团队权限管理

七、Trae AI 与其他工具对比

1. 与 Cursor 对比

2. 与 GitHub Copilot 对比

• 优势：
  • 全功能 IDE 而不仅是插件
  • 支持项目级代码生成而不仅是补全
  • 提供 Builder 模式从零构建项目
• 不足：
  • 插件市场不如 VS Code 丰富
  • 国际版需要网络代理

3. 选择建议

• 中文开发者：优先选择 Trae 国内版
• 需要 GPT-4o：使用 Trae 国际版
• 已有 VS Code 配置：Trae 可无缝迁移

八、总结与后续建议

Trae AI 作为一款新兴的 AI 原生 IDE，凭借其强大的代码生成能力、流畅的中文支持和免费的高级模型，已经成为中文开发者的有力工具。通过本教程，您应该已经掌握了：

1. 安装配置：正确安装并设置适合您开发需求的版本
2. 核心功能：熟练使用 Chat 和 Builder 两种模式
3. 调试技巧：有效解决开发中的常见问题
4. 最佳实践：编写优质提示词和团队协作方法

后续学习建议：

• 从简单项目开始，如待办清单、天气查询工具
• 每天花 30 分钟实践小案例，逐步熟悉 AI 协作
• 关注官方更新，Trae 仍在快速迭代中

随着 AI 编程工具的不断发展，掌握像 Trae 这样的 AI 辅助工具将成为开发者的必备技能。希望本教程能帮助您顺利开始 Trae AI 的使用之旅，提升开发效率，创造更多价值。