Trae IDE 安装与使用指南：字节跳动 AI 原生开发环境

点击首页的"立即下载"按钮，选择对应系统的版本：

• Windows 用户下载 .exe 安装包
• macOS 用户下载 .dmg 安装包

步骤 3：运行安装程序

1. 双击下载的安装包
2. 点击"同意"许可协议
3. 选择安装路径（建议保持默认）
4. 点击"下一步"完成安装

步骤 4：首次启动

安装完成后，桌面会出现 Trae 图标。双击启动，你会看到模式选择界面：

三、Trae 的三种开发模式

Trae 提供三种 AI 开发模式，适应不同场景：

3.1 Chat 模式（智能问答）

适合场景：日常编码辅助、代码解释、Bug 修复

核心功能：

• ✅ 智能代码补全（Tab 键一键接受）
• ✅ 代码解释（选中代码，右键"解释"）
• ✅ 智能问答（侧边栏 Chat 功能）
• ✅ 代码优化建议
• ✅ Bug 诊断与修复

使用示例：

# 输入注释，按 Tab 自动补全代码
# 计算斐波那契数列的前 n 项
def fibonacci(n):
    """Trae 会自动补全这个函数的实现"""
    if n <= 0:
        return []
    elif n == 1:
        return [0]
    elif n == 2:
        return [0, 1]
    fib = [0, 1]
    for i in range(2, n):
        fib.append(fib[i-1] + fib[i-2])
    return fib

3.2 Builder 模式（项目生成）

适合场景：快速搭建项目框架、原型开发

核心功能：

• 🏗️ 自然语言描述需求，一键生成完整项目
• 📁 自动创建项目结构和文件
• 🎨 自动配置技术栈和依赖
• 📝 生成基础代码和注释

使用示例：

在 Builder 模式的对话框中输入：

帮我创建一个 Python 爬虫项目，爬取豆瓣电影 Top250 的电影信息，包括电影名、评分、导演、主演，保存到 CSV 文件中。使用 requests + BeautifulSoup，包含异常处理和日志记录。

Trae 会自动：

1. 创建项目文件夹 douban-spider/
2. 生成 spider.py - 爬虫主程序
3. 生成 requirements.txt - 依赖列表
4. 生成 README.md - 项目说明
5. 生成 config.py - 配置文件

3.3 SOLO 模式（AI 自主开发）

适合场景：自动化任务、快速原型、非专业程序员

核心功能：

• 🤖 AI 自主规划并执行开发任务
• 🔄 自动迭代优化代码
• 📊 自动运行测试和调试
• 🎯 自动完成端到端开发

使用示例：

创建一个待办事项 Web 应用，使用 Flask 框架。功能包括：添加任务、标记完成、删除任务、显示所有任务。前端使用简单的 HTML 和 CSS，要求界面美观。

Trae 会自动完成从项目创建到运行测试的整个流程。

四、AI 模型选择与切换

4.1 国内版模型阵容

国内版主打国产大模型联盟，覆盖字节跳动、智谱 AI、MiniMax、月之暗面等国内顶尖 AI 厂商：

国内版优势：

• ✅ 国产模型针对中文编程场景深度优化
• ✅ 对国内技术栈（Vue、Ant Design、Element Plus 等）理解更深入
• ✅ 网络访问零延迟，响应速度快
• ✅ 符合国内数据合规要求
• ✅ 完全免费使用

4.2 国际版模型阵容

国际版汇聚全球顶尖 AI 模型，覆盖 OpenAI、Google、DeepSeek、月之暗面等国际厂商：

国际版优势：

• ✅ GPT-5 系列在代码生成质量上处于全球领先地位
• ✅ Gemini-3 系列支持超长上下文，适合大型项目
• ✅ 多语言支持能力强，适合国际化开发
• ✅ 在算法、数据结构等计算机科学基础领域表现卓越

4.3 模型切换方法

切换步骤：

1. 点击左下角模型名称（如"Doubao-1.5-pro"）
2. 在弹出的模型列表中选择想要的模型
3. 新对话将使用选中的模型

选择建议：

五、实战案例

案例 1：用 Builder 模式创建项目

需求：创建一个 Vue 3 + TypeScript 的电商后台管理系统

步骤：

1. 切换到 Builder 模式
2. 等待 AI 自动生成项目
3. 按提示运行项目

在对话框输入：

创建一个电商后台管理系统，使用 Vue 3 + TypeScript + Element Plus，包含商品管理、订单管理、用户管理、数据统计四大模块，要求界面美观、响应式布局，并包含登录页面。

Trae 会自动生成：

• src/components/ - 组件目录
• src/views/ - 页面目录
• src/router/ - 路由配置
• src/store/ - 状态管理
• package.json - 项目配置

案例 2：用 Chat 模式调试代码

场景：遇到一个 Bug，不知道原因

步骤：

1. 选中报错的代码
2. 右键选择"解释代码"
3. Trae 会分析代码并指出问题
4. 点击"修复"按钮，自动修复 Bug

示例：

# 有 Bug 的代码
def divide(a, b):
    return a / b  # 没有处理 b=0 的情况

# Trae 会提示：
# "这段代码存在除零风险，建议添加异常处理"

# 修复后的代码
def divide(a, b):
    try:
        return a / b
    except ZeroDivisionError:
        return "错误：除数不能为零"

案例 3：用 SOLO 模式完成自动化任务

场景：需要批量处理数据文件

步骤：

1. 切换到 SOLO 模式
2. Trae 自动编写、运行、验证代码

描述任务：

帮我写一个 Python 脚本，批量处理当前文件夹下的所有 CSV 文件，将每个文件的第一列数据求和，并将结果保存到新的 CSV 文件中。

六、Trae 插件版使用

6.1 插件版 vs IDE 版

6.2 安装 Trae 插件（VS Code）

1. 打开 VS Code
2. 点击左侧扩展图标（或按 Ctrl+Shift+X）
3. 搜索 "Trae"
4. 点击"安装"
5. 安装完成后，左侧会出现 Trae 图标

6.3 插件版功能

插件版提供核心 AI 功能：

• Chat 智能问答
• 代码补全
• 代码解释
• Bug 修复

⚠️ 注意：Builder 模式和 SOLO 模式仅在 Trae IDE 完整版中提供。

七、常见问题与解决方案

Q1：国内版和国际版有什么区别？

选择建议：

• 国内用户优先选择国内版，网络稳定、中文支持好、完全免费
• 海外用户或有国际网络环境的用户可选择国际版，模型能力更强

Q2：Trae 会泄露我的代码吗？

Trae 官方承诺：

• 代码仅用于提供 AI 服务
• 不会用于训练模型
• 国内版数据处理在境内，符合合规要求

Q3：可以导入 VS Code 的配置吗？

可以！Trae IDE 基于 VS Code 开发，支持：

• 导入 VS Code 的设置
• 安装 VS Code 插件
• 使用 VS Code 快捷键

Q4：免费版有使用限制吗？

国内版：完全免费，无使用限制 国际版：有免费额度限制，重度使用需购买订阅

Q5：支持哪些编程语言？

Trae 支持主流编程语言：

• Python、JavaScript/TypeScript
• Java、Go、Rust
• C/C++、C#
• HTML/CSS、SQL
• 以及更多…

八、自定义智能体：打造专属 AI 助手

Trae 最强大的功能之一是支持创建自定义智能体。通过配置专属的提示词和工具集，你可以打造面向特定开发场景的编程助手。

8.1 什么是自定义智能体？

自定义智能体是 Trae 中面向特定开发场景的编程助手。与通用 Chat 不同，自定义智能体：

• 🎯 专注特定领域：如前端架构、后端开发、代码审查等
• 🛠️ 集成专属工具：通过 MCP 连接数据库、API 等外部服务
• 📋 遵循团队规范：封装代码风格、审查标准等团队规范
• 🤝 支持分享导入：一键分享给团队成员使用

8.2 创建自定义智能体

步骤 1：打开智能体管理

1. 点击左侧边栏的"智能体"图标
2. 点击"创建智能体"按钮

步骤 2：配置智能体

┌─────────────────────────────────────┐
│ 创建自定义智能体 │
│                                     │
│ 名称：前端架构师                    │
│ 描述：专注于 React/Vue 组件设计     │
│                                     │
│ 提示词（Prompt）：                  │
│ ─────────────────────────────────── │
│ 你是一位资深前端架构师，精通       │
│ React、Vue、Angular 等主流框架。    │
│                                     │
│ 职责：                              │
│ 1. 设计可维护、可扩展的前端架构    │
│ 2. 提供性能优化方案                 │
│ 3. 制定代码规范和最佳实践           │
│ 4. 指导组件设计和状态管理           │
│                                     │
│ 输出要求：                          │
│ - 提供具体的代码示例                │
│ - 解释设计决策的原因                │
│ - 指出潜在的风险和注意事项          │
│ ─────────────────────────────────── │
│                                     │
│ [添加 MCP 工具] [保存] [分享]        │
└─────────────────────────────────────┘

步骤 3：添加 MCP 工具（可选）

点击"添加 MCP 工具"，从 MCP 市场选择需要的工具：

• 数据库操作工具
• API 调用工具
• 文件系统工具
• 代码分析工具

8.3 推荐的自定义智能体类型

8.4 分享与导入智能体

分享智能体：

1. 创建完成后，点击"分享"按钮
2. 生成分享链接：trae://agent/import?agent=xxx&id=xxx
3. 将链接分享给团队成员

导入智能体：

1. 点击他人分享的链接
2. 跟随指引一键导入
3. 在聊天窗口中选择该智能体即可使用

九、MCP：无限扩展的工具生态

9.1 什么是 MCP？

MCP（Model Context Protocol，模型上下文协议） 是一种开放协议，它允许大语言模型访问自定义的工具和服务。通过 MCP，AI 可以：

• 调用外部 API 获取实时数据
• 操作文件系统和数据库
• 与第三方服务集成
• 执行特定的业务逻辑

9.2 MCP 架构

┌─────────────────┐ ┌─────────────┐ ┌─────────────────┐
│ Trae 智能体     │────▶│ MCP 客户端 │────▶│ MCP Server    │
│ (Agent/Builder) │     │ (内置)    │     │ (外部工具服务)│
└─────────────────┘ └─────────────┘ └─────────────────┘
        ▼
┌─────────────┐
│ 第三方服务  │
│ - 数据库    │
│ - API       │
│ - 文件系统  │
└─────────────┘

9.3 MCP 市场

Trae 内置了 MCP 市场，提供了社区中上百个热门的 MCP Servers：

添加 MCP Server 的方式：

1. 从市场添加：浏览 MCP 市场，一键安装所需工具
2. 手动添加：配置自定义 MCP Server 的地址和参数

9.4 MCP 使用示例

场景：连接数据库，自动生成 CRUD 代码

1. 在智能体中添加 PostgreSQL MCP Server
2. 输入需求："根据 users 表结构生成 CRUD API"
3. AI 自动查询表结构，生成对应的代码

十、Rules：让 AI 更听话的秘密

10.1 什么是 Rules？

Rules 是 Trae 中用于控制 AI 行为的规则系统。通过 Rules，你可以：

• 设定代码风格规范
• 定义项目目录结构
• 指定输出格式要求
• 控制规则生效时机

10.2 Rules 的四种生效方式

TRAE Rules 提供了 4 种生效方式，用来控制适用范围与时机：

10.3 多规则管理

Trae 支持配置多条 Rule 文件，把不同主题/职责拆到不同文件里：

规则文件结构示例：

.trae/
├── frontend-general.md      # 始终生效：通用前端规范
├── react-components.md      # 指定文件生效：React 组件规范
├── css-styling.md           # 指定文件生效：CSS 样式规范
├── performance-optimization.md # 智能生效：性能优化指南
└── debugging-sop.md         # 手动触发：调试标准流程

优势：

• ✅ 可维护性：每条规则只管一类事情，修改更集中
• ✅ 可协作性：团队可以按职责分工维护不同规则文件
• ✅ 可组合性：不同项目可以复用同一组模块

10.4 Rules 编写技巧

规则编写原则：

1. 保持简洁：每条规则尽量控制在合理长度，专注于核心内容
2. 明确边界：清晰定义规则的适用范围和不适用场景
3. 提供示例：为复杂规则提供具体的示例，帮助模型理解
4. 定期更新：建立规则的定期审查和更新机制

示例 Rule 文件：

# 前端开发规范
## 代码风格
- 使用 2 个空格缩进
- 使用单引号而非双引号
- 最大行长度 100 字符

## React 组件规范
- 函数组件优先，使用 Hooks
- Props 必须定义类型（TypeScript）
- 组件名使用 PascalCase

## 性能优化
- 图片使用 WebP 格式
- 大列表使用虚拟滚动
- 避免不必要的重渲染

十一、进阶技巧

11.1 自定义快捷键

Trae 支持自定义快捷键：

1. 打开设置（Ctrl+,）
2. 搜索"快捷键"
3. 自定义你喜欢的快捷键

推荐设置：

• Ctrl+Shift+A - 打开 Chat
• Ctrl+Shift+B - 打开 Builder
• Tab - 接受 AI 建议（默认）

11.2 提示词优化技巧

1. 明确技术栈：在 Prompt 中明确指定框架和库版本
2. 提供示例：给出期望的代码风格示例
3. 分步骤描述：复杂需求拆分为多个步骤
4. 指定输出格式：明确代码注释语言（中文/英文）

示例：

请帮我写一个 Python 函数，使用 pandas 读取 CSV 文件，
要求：
1. 处理文件不存在的情况
2. 处理编码错误
3. 返回 DataFrame 对象
4. 添加详细的中文注释

11.3 使用代码片段（Snippets）

Trae 支持代码片段：

1. 打开用户代码片段（Ctrl+Shift+P → '配置用户代码片段'）
2. 创建自定义片段
3. 输入前缀快速插入代码

示例 Python 片段：

{
  "FastAPI Hello World": {
    "prefix": "fastapi-hello",
    "body": [
      "from fastapi import FastAPI",
      "",
      "app = FastAPI()",
      "",
      '@app.get("/")',
      "async def root():",
      '    return {"message": "Hello World"}'
    ],
    "description": "FastAPI 基础模板"
  }
}

十二、总结

Trae 的核心优势

✅ AI 原生：不是插件，而是深度集成 AI 的 IDE ✅ 三模式：Chat、Builder、SOLO 适应不同场景 ✅ 双版本：国内版免费稳定，国际版模型顶尖 ✅ 自定义智能体：打造专属 AI 助手，提升专业领域效率 ✅ MCP 生态：无限扩展的工具集成能力 ✅ Rules 体系：精准控制 AI 行为，确保输出质量 ✅ 易上手：基于 VS Code，学习成本低 ✅ 插件支持：也可作为插件在现有 IDE 中使用

适合谁使用？

• 👨‍💻 程序员：提升编码效率，减少重复劳动
• 🎓 学生：学习编程，快速理解代码
• 🏢 企业：统一开发工具，提升团队效率
• 🤖 AI 爱好者：体验 AI 辅助编程的魅力

官网参考

• 国内版：https://www.trae.com.cn/
• 国际版：https://www.trae.ai/