字节跳动 Trae AI 编程工具 —— 保姆级完整使用教程

1

Trae 是什么？

了解 Trae 的产品定位、核心优势与适用人群

📌产品定位

Trae（The Real AI Engineer）是字节跳动推出的 AI 原生集成开发环境（IDE），基于 VS Code 内核深度改造，不是简单的"IDE + AI 插件"，而是从底层重构、将 AI 能力融入每一个开发环节的全新编程工具。

简单来说：你用自然语言描述需求，Trae 帮你写代码、建项目、装依赖、跑程序、修 Bug，一条龙全自动完成。

🌐

国内版 https://www.trae.cn
手机号登录，内置豆包/DeepSeek 等国产模型，无需翻墙

🌍

国际版 https://www.trae.ai
Google/GitHub 登录，接入 Claude/GPT 等海外模型

⚠️

国内用户请务必使用 trae.cn，避免下载错版本导致无法使用。

✨ 核心优势一览

🆓

基础功能永久免费

不像 Cursor 高级功能需付费订阅，Trae 核心 AI 能力全部免费

🇨🇳

原生中文支持

界面全中文，对中文需求理解精准，无需写英文 Prompt

🚀

零配置开箱即用

自动识别环境、安装依赖、修复报错，告别繁琐配置

🤖

多种顶级大模型

内置豆包、DeepSeek、Kimi、GLM、MiniMax 等，可自由切换

🔄

VS Code 无缝迁移

一键导入插件、快捷键、主题、用户设置，零切换成本

🎨

设计稿转代码

上传 UI 截图/设计稿，自动生成响应式前端代码

📦

SOLO 全自动开发

AI 自主拆解任务、编码、测试、部署，全程无需手动操作

🔌

MCP 协议扩展

支持连接外部工具和服务，无限扩展 AI 能力

👥 适用人群

🔰

零基础小白

不懂代码也能做网页、小工具、脚本

🎓

在校学生

课程作业、毕业设计、编程学习

🎨

前端开发者

设计稿转代码、快速搭建页面

⚙️

后端开发者

快速生成 API、数据库操作代码

🏗️

全栈开发者

一站式完成前后端 + 数据库开发

📋

产品经理/运营

无需开发资源，自己动手做原型和小工具

2

下载与安装

Windows / macOS / Linux 全平台安装指南

系统	官网	安装包格式
Windows 10/11	https://www.trae.cn	`.exe`
macOS（Intel）	https://www.trae.cn	`.dmg`
macOS（Apple Silicon M1-M4）	https://www.trae.cn	`.dmg`（ARM 版）
Linux	https://www.trae.cn	`.deb` / `.rpm`

💡

官网会自动识别你的操作系统，推荐对应版本。

🖥️Windows 安装步骤

打开浏览器，访问 https://www.trae.cn

点击页面上的「下载」按钮，下载 .exe 安装包

双击安装包

如 Trae CN-Setup-x64.exe，安装向导启动后一路点击「下一步」即可

可选：自定义安装路径

建议保持默认 C:\Users\你的用户名\AppData\Local\Programs\Trae CN\

等待安装完成

约 1-2 分钟，勾选「立即启动 Trae」，点击「完成」

🍎macOS 安装步骤

下载对应芯片版本的 .dmg 文件

Apple Silicon（M 系列芯片）→ 下载 ARM 版；Intel Mac → 下载 Intel 版

双击 .dmg 文件打开

将 Trae 图标拖拽到 Applications（应用程序）文件夹

打开启动台，找到 Trae 点击启动

首次打开若提示"无法验证开发者"，前往 系统设置 → 隐私与安全性 → 仍要打开

🐧Linux 安装步骤

下载对应格式的包

Ubuntu/Debian 系 → .deb；CentOS/Fedora 系 → .rpm

终端执行安装命令

bash

# Debian/Ubuntu
sudo dpkg -i Trae*.deb
sudo apt-get install -f  # 修复依赖

# Fedora/CentOS
sudo rpm -i Trae*.rpm

⚙️首次启动初始化配置

第 1 步：选择主题

暗色（推荐）：写代码护眼，大多数人选择 | 亮色：适合明亮环境 | 深蓝：偏蓝色调的暗色主题

第 2 步：选择显示语言

选择「简体中文」，界面将完全中文化，无需额外安装汉化包

第 3 步：导入 VS Code / Cursor 配置（可选）

点击「从 VS Code 导入」或「从 Cursor 导入」，自动同步主题、快捷键、已装插件、用户设置。新手直接点击「跳过」

第 4 步：安装命令行工具（可选）

建议点击「安装」，之后可在终端中使用 trae . 快速打开项目

第 5 步：登录账号

支持手机号登录（推荐）和稀土掘金账号登录。⚠️ 必须登录才能使用 AI 功能

✅验证安装成功

登录成功后，你应该能看到：

✅ 左侧有文件资源管理器 ✅ 右侧有 AI 面板（Chat / Builder / SOLO） ✅ 底部有终端面板 ✅ 右上角显示已登录状态

3

界面详解

认识 Trae 的五大核心区域

┌─────────────────────────────────────────────────────────────┐ │ 菜单栏（文件/编辑/选择/视图/转到/运行/终端/帮助） │ ├──────┬──────────────────────────────┬──────────────────────┤ │ │ │ │ │ 左侧 │ 中间编辑区 │ 右侧 AI 面板 │ │ 栏 │ （代码编辑器） │ （Chat/Builder/SOLO）│ │ │ │ │ ├──────┴──────────────────────────────┴──────────────────────┤ │ 底部面板（终端 / 输出 / 问题 / 调试控制台） │ └─────────────────────────────────────────────────────────────┘

📁

左侧栏 - 资源管理器

查看和管理项目文件/文件夹，还有搜索、Git、调试、扩展、智能体等图标按钮

📝

中间编辑区

多标签页、语法高亮、代码折叠、迷你地图、分屏编辑

🤖

右侧 AI 面板

Chat（问答）、Builder（建项目）、SOLO（全自动开发）三个标签

⚡

底部面板

终端、输出、问题列表、调试控制台

🤖 右侧 AI 面板 —— 最核心区域

标签	名称	用途
💬	Chat	AI 问答、代码解释、Bug 修复、代码生成
🏗️	Builder	一句话生成完整项目（从 0 到 1）
🤖	SOLO	AI 全自动开发模式（王牌功能）

4

三大核心开发模式

IDE 模式 / Chat 模式 / SOLO 模式 —— 理解区别是高效使用 Trae 的关键

💻

IDE 模式

手动编码 + AI 辅助

最传统的开发方式，你手动写代码，AI 在旁边辅助。

智能补全：输入时自动提示，按 Tab 采纳
侧边 Chat：随时和 AI 对话
选中即问：右键 → Ask Trae
AI 修复：报错时一键排查

🎯 适合：想学编程的人、需要精细控制代码的开发者

💬

Chat 模式

AI 问答助手

你和 AI 的对话窗口，写代码、解释代码、修 Bug、优化性能。

问任何编程问题
让 AI 写一段代码插入编辑器
选中代码后提问
生成单元测试、注释、API 文档

⌨️ 快捷键：Ctrl+I / Cmd+I

🤖

SOLO 模式

AI 全自动开发

Trae 最强大的功能，AI 全权接管开发流程。

SOLO Builder：快速原型开发
SOLO Coder：复杂项目工程化
多智能体协作
全程只需描述需求

🚀 适合：快速出活、做原型、毕设

你输入需求 → AI 分析需求 → AI 创建文件结构 → AI 编写代码 → AI 安装依赖 → AI 运行测试 → AI 预览成果 → 你验收

📊 三种模式对比

维度	IDE 模式	Chat 模式	SOLO 模式
掌控感	⭐⭐⭐ 完全掌控	⭐⭐ 半掌控	⭐ 全自动
效率	⭐⭐ 较慢	⭐⭐⭐ 较快	⭐⭐⭐⭐ 最快
学习价值	⭐⭐⭐⭐ 最高	⭐⭐⭐ 较高	⭐⭐ 较低
适合场景	学习、精细开发	问答、片段开发	快速出活、原型

💡

选择建议：
🔰 零基础学习 → 先用 IDE + Chat 模式，理解代码逻辑
🛠️ 做课程作业/毕设 → SOLO Builder 一键生成，再手动调整
💼 职场快速出活 → SOLO 模式，描述需求即可
🐛 修 Bug/优化代码 → Chat 模式，选中代码直接问

5

Builder 模式 —— 一句话生成完整项目

最具冲击力的功能：描述需求，AI 自动搭建整个项目

🏗️什么是 Builder？

Builder 是 Trae 最具冲击力的功能：你用一段话描述想要什么，AI 自动帮你搭建整个项目。它能做到：

📁 自动创建项目目录结构 ✍️ 生成所有必要的代码文件 📦 安装所需的依赖包 ▶️ 启动开发服务器 👁️ 在 Webview 中预览成果

📋 使用步骤

打开 Builder

点击右侧 AI 面板 → 切换到「Builder」标签，或切换到 SOLO 模式后选择 SOLO Builder

输入需求描述

在对话框中输入你的需求，越详细越好

等待 AI 生成

AI 逐步执行：📋 分析需求 → 📁 创建结构 → ✍️ 编写代码 → 📦 安装依赖 → ▶️ 启动项目

预览成果

点击「预览」按钮，Webview 窗口弹出，展示运行效果

迭代修改

不满意？直接说："把按钮颜色改成蓝色"、"加一个搜索功能"、"字体大一点"

🔥 实战案例

✅案例 1：待办事项网页

用 HTML + CSS + JavaScript 做一个极简深色模式待办清单应用：

Prompt 示例

用 HTML + CSS + JavaScript 做一个极简深色模式待办清单应用，要求：
1. 支持添加、删除、标记完成待办事项
2. 使用 localStorage 本地存储，刷新不丢失
3. 界面简洁美观，深色主题
4. 有动画效果（添加/删除时的过渡动画）
5. 显示已完成/未完成的统计数量

💬

追加修改示例："把主题色改成紫色" | "加一个筛选功能：全部/已完成/未完成" | "加一个清空所有按钮，带确认弹窗"

🐍案例 2：贪吃蛇小游戏

Prompt 示例

使用 Python 和 pygame 开发一个经典贪吃蛇小游戏，要求：
1. 方向键控制蛇移动
2. 随机生成食物
3. 吃食物得分增加，蛇身变长
4. 撞墙或撞到自己则游戏结束
5. 显示当前得分和最高分
6. 游戏结束可以重新开始
7. 代码规范，注释详细

AI 会自动检查是否安装了 pygame，如果没有，自动执行 pip install pygame

🎓案例 3：学生管理系统

Prompt 示例

用 Python Flask 做一个学生管理系统，要求：
1. 学生信息包括：学号、姓名、年龄、专业、成绩
2. 支持增删改查操作
3. 使用 SQLite 数据库存储
4. 有简单的 Web 界面（HTML 模板）
5. 密码加密存储
6. 返回 JSON 格式的 API 接口

🔌

Builder with MCP：在 Builder 基础上自动接入你配置的所有 MCP Server，AI 可以查询数据库、调用第三方 API、操作文件系统等。

6

Chat 模式 —— 你的随身 AI 编程老师

唤起方式、核心用法、上下文引用技巧

唤起方式	操作
快捷键	`Ctrl + I`（Windows）/ `Cmd + I`（Mac）
鼠标点击	右侧 AI 面板 → Chat 标签
右键菜单	选中代码 → 右键 → 「Ask Trae」
错误提示	点击报错旁边的「AI 修复」按钮

🛠️ 核心用法

📖

代码解释

"帮我逐行解释这段代码的逻辑"

🐛

Bug 修复

"这段代码报错 xxx，帮我排查原因并修复"

⚡

代码优化

"优化这段代码的性能，给出修改前后对比"

📝

生成注释

"为这段代码生成详细的注释"

🧪

生成单元测试

"为这个函数生成单元测试，覆盖正常和异常场景"

🔍

API 使用咨询

"Python 中 pandas 怎么按条件筛选数据？给几个例子"

🎯 上下文引用技巧（@ 和 #）

符号	用法	效果
`@文件名`	`@main.py 帮我看看入口逻辑`	AI 读取指定文件内容
`#Workspace`	`#Workspace 分析整个项目架构`	AI 分析整个项目
`#文件夹名`	`#src/api 梳理接口`	AI 分析指定文件夹
选中代码 + 提问	选中后直接输入问题	AI 结合选中代码回答

7

CUE 智能编程工具

Code Understanding & Enhancement —— 深度集成的智能编码体验

🔮

智能代码补全

正常输入代码，Trae 自动弹出补全建议。按 Tab 采纳，按 Ctrl+→ 逐字接受，按 Esc 取消

⚡

CUE-Pro 主动触发

Ctrl+Shift+Enter 主动触发更强大的补全，或输入注释后换行让 AI 生成完整代码块

↗️

Tab to Jump 智能跳转

采纳补全后按 Tab，光标自动跳到 AI 预判的下一个编辑位置，修改表单、重命名时极其丝滑

📥

智能导入

直接写 np.array()，Trae 自动在文件顶部添加 import numpy as np

✏️

智能重命名

选中变量名 → 按 F2 → 输入新名称 → 回车，所有引用处全部自动更新

示例：注释驱动开发

# 写一个函数，计算斐波那契数列的第n项，使用动态规划
# （换行后 AI 自动生成完整函数）

def fibonacci(n):
    if n <= 1:
        return n
    dp = [0] * (n + 1)
    dp[1] = 1
    for i in range(2, n + 1):
        dp[i] = dp[i-1] + dp[i-2]
    return dp[n]

8

内置智能体（Agent）系统

面向不同开发场景的 AI 编程助手

智能体	图标	功能定位
Chat	💬	通用对话助手，聊代码、写片段、回答问题
Builder	🏗️	从 0 到 1 构建完整项目
Builder with MCP	🔌	Builder + 外部工具接入
SOLO Coder	🤖	复杂项目工程化开发（SOLO 模式专用）
Prd Writer	📝	撰写产品需求文档
Figma Agent	🎨	处理 Figma 设计稿相关任务
Bug Fixer	🐛	自动排查和修复 Bug

🤖SOLO Coder 详解

面向专业开发者的工程化智能体，核心能力包括：

需求迭代开发架构重构 Bug 修复多任务并行处理智能体协同

使用步骤：切换到 SOLO 模式 → 点击 @ 符号 → 选择 SOLO Coder → 输入复杂需求 → AI 先输出任务计划等你确认 → 确认后自动逐步执行

🛠️自定义智能体

点击右侧 AI 面板 → 智能体列表 → 「创建智能体」，填写名称、描述、系统提示词、工具集即可。

💡

示例：创建一个"代码审查员"智能体，系统提示词设定为"你是一位资深代码审查专家，重点关注安全漏洞、性能问题、代码规范"，工具集勾选文件读取和代码搜索。

9

模型选择与配置

内置多个顶级大模型，可随时切换或接入自定义模型

模型名称	厂商	擅长领域	推荐场景
Doubao-Seed-2.0-Code	字节跳动	代码生成、代码理解	日常编码首选
Doubao-Seed-1.8	字节跳动	通用对话、代码辅助	综合平衡
DeepSeek-V3.1-Terminus	深度求索	复杂推理、算法	疑难 Bug、架构设计
Kimi-K2.5	月之暗面	长文本理解、文档分析	大项目分析
GLM-5	智谱AI	中文理解、代码生成	中文需求描述
GLM-5.1	智谱AI	综合增强	复杂任务
MiniMax-M2.7	MiniMax	代码生成	快速开发
ZGLM-5V-Turbo	智谱AI	多模态、快速响应	看图写代码

🔄 切换模型方法

方法 1：AI 面板切换

打开右侧 AI 面板 → 看对话框右下角当前模型名称 → 点击弹出模型列表 → 选择

方法 2：命令面板切换

按 Ctrl+Shift+P → 输入 "model" → 选择 "Trae: 切换模型"

🤖

Auto 模式：系统会根据你的需求自动选择最合适的模型 —— 简单补全用轻量模型，复杂推理用重型模型，日常对话用均衡型。新手建议直接开 Auto 模式，省心省力。

📊 模型选择建议

任务类型	推荐模型	理由
日常代码补全	Doubao-Seed-Code	速度快、轻量
完整项目生成	Doubao-Seed-2.0-Code	代码能力强
复杂算法/架构	DeepSeek-V3.1	推理能力顶尖
中文需求理解	GLM-5 / Doubao-Seed	中文优化好
大项目全局分析	Kimi-K2.5	长文本处理强
看图写代码	GLM-5V-Turbo	多模态能力强
不确定用什么	Auto 模式	系统自动选

10

多模态：设计稿转代码

上传 UI 设计稿，AI 自动分析布局、颜色、组件结构，生成前端代码

切换到 Builder 或 SOLO 模式

在对话框旁点击 📎（附件）按钮

选择「上传图片」

选择你的设计稿（UI 设计稿、手绘草图、网页截图均可）

输入需求描述

除了图片，文字描述也要具体

AI 自动解析 → 生成代码 → 预览效果

Prompt 示例

基于这张设计稿，使用 Vue3 + Element Plus 实现页面，要求：
1. 精准还原布局和样式
2. 适配 PC 端，响应式布局
3. 交互功能可用（按钮点击、表单提交等）
4. 代码结构清晰，组件化拆分

💡

效果优化技巧：
📷 上传高清大图，效果远好于模糊小图
📝 文字描述补充细节（"顶部导航栏固定"、"卡片间距 16px"）
🔄 分步生成：先搭骨架，再逐步细化每个区域
🎯 迭代修改："左侧边栏宽度调大"、"卡片圆角改成 8px"

11

Skills 技能系统

给 AI 装上不同职业的"工作手册"

📦什么是 Skill？

Skill（技能）是给 Trae 的 AI 配置的"专业能力说明书"。每个 Skill 是一个 Markdown 文件，告诉 AI 在特定场景下应该如何行动。

⭐ 推荐 Skill 清单

序号	技能名称	核心功能	适用场景
1	Document Processing	生成 Word/Excel/PPT/PDF	办公文档自动化
2	NanoBanana-PPT	分析文档生成动画 PPT	做汇报演示
3	Remotion	用代码制作视频动画	视频内容创作
4	Pencil	设计原型、兼容 Figma	UI 设计
5	GitHub Skills	自动创建 PR、代码审查	Git 协作
6	Notion Skills	同步内容到 Notion	知识管理
7	Frontend-Design	前端设计规范生成	前端开发
8	PDF Processing	PDF 读取、合并、提取	文档处理
9	Excel Analysis	Excel 数据分析处理	数据分析
10	API Doc Gen	自动生成 API 文档	后端开发

创建 Skill 的 SKILL.md 文件

# 手动创建 Skill
mkdir -p .trae/skills/my-skill

# SKILL.md 内容
---
name: "my-skill"
description: "这个技能的作用描述"
---

# 技能名称

详细说明 AI 在这个场景下应该怎么做，包括：
- 步骤一：xxx
- 步骤二：xxx
- 注意事项：xxx

12

MCP 模型上下文协议

让 Trae 的 AI 能"伸手"到外部世界

🌐

访问互联网

搜索信息

🗄️

连接数据库

查询数据

📁

操作文件系统

读写文件

🔗

调用第三方 API

扩展能力

🐙

操作 GitHub

仓库管理

🔌 常用 MCP Server

MCP Server	功能	安装方式
Puppeteer	浏览器自动化、网页截图	Trae 内置
PostgreSQL	连接 PostgreSQL 数据库	Trae 内置
GitHub	GitHub 仓库操作	Trae 内置
Figma	Figma 设计稿读取	Trae 内置
Sequential Thinking	分步推理思考	Trae 内置
Memory	跨会话记忆存储	Trae 内置
Filesystem	高级文件操作	手动配置

MCP Server 配置示例 (JSON)

{
  "name": "my-mcp-server",
  "command": "npx",
  "args": ["-y", "@modelcontextprotocol/server-xxx"],
  "env": {
    "API_KEY": "your-key-here"
  }
}

13

Git 与版本控制

AI 辅助的 Git 工作流

📝

AI 辅助提交

勾选要提交的文件 → 输入 / 触发斜杠命令 → 选择「AI 生成提交信息」→ AI 自动分析变更生成规范 commit message

🔀

代码冲突解决

Trae 自动标记冲突文件 → 点击「AI 解决冲突」→ AI 分析双方修改给出最优合并方案 → 确认即可

⏪

版本历史与回滚

点击「Show History」→ 看到每轮 AI 修改的快照列表 → 点击预览 → 点击「恢复」回到该版本

AI 生成的 Commit Message 示例

feat(user): 添加用户登录和注册功能

- 实现 JWT token 认证
- 添加密码加密存储
- 增加登录失败次数限制

14

实战项目演练

三个完整项目，从简单到复杂，跟着做一遍就上手

🍅项目 1：番茄钟 Web 应用

目标：做一个功能完整的番茄工作法计时器

Prompt

用 React + Vite + Tailwind CSS 做一个番茄钟应用：

【核心功能】
1. 25 分钟工作倒计时，可以暂停和重置
2. 5 分钟短休息倒计时
3. 15 分钟长休息（每完成 4 个番茄钟后触发）
4. 完成次数统计（今日/总计）

【UI 要求】
1. 深色主题，渐变背景
2. 计时器数字用大号等宽字体
3. 圆形进度条展示剩余时间
4. 响应式布局，手机端也能用

【额外功能】
1. 计时结束有声音提醒
2. 可以自定义工作时间/休息时间
3. 任务列表：当前在做什么

📝项目 2：个人博客系统

技术栈：Python Flask + SQLite + Bootstrap 5

首页：文章列表（标题、摘要、日期、标签）
文章详情页：Markdown 渲染、代码高亮
管理员登录 + Markdown 编辑器
RSS Feed 输出
Docker Compose + Nginx 反向代理配置

📊项目 3：数据可视化仪表盘

技术栈：Python + Streamlit + Plotly

KPI 指标卡片（总销售额、总订单数、平均客单价、总利润）
销售趋势折线图（按日/周/月）
产品销量柱状图 Top 10
地区分布地图 + 利润热力图
筛选器联动所有图表，图表可下载为 PNG

15

快捷键大全

掌握快捷键，效率翻倍

🤖 AI 相关快捷键

操作	Windows	macOS
唤起 AI Chat 面板	`Ctrl + I`	`Cmd + I`
唤起内联 AI 编辑	`Ctrl + K`	`Cmd + K`
主动触发 CUE-Pro	`Ctrl + Shift + Enter`	`Cmd + Shift + Enter`
接受补全建议	`Tab`	`Tab`
逐字接受补全	`Ctrl + →`	`Cmd + →`
取消补全	`Esc`	`Esc`

📝 编辑器快捷键

操作	Windows	macOS
打开命令面板	`Ctrl + Shift + P`	`Cmd + Shift + P`
快速打开文件	`Ctrl + P`	`Cmd + P`
保存文件	`Ctrl + S`	`Cmd + S`
注释/取消注释	`Ctrl + /`	`Cmd + /`
格式化代码	`Shift + Alt + F`	`Shift + Option + F`
全局搜索	`Ctrl + Shift + F`	`Cmd + Shift + F`
重命名符号	`F2`	`F2`
转到定义	`F12`	`F12`
拆分编辑器	`Ctrl + \`	`Cmd + \`

⚡ 终端快捷键

操作	Windows	macOS
打开/关闭终端	Ctrl + `	Cmd + `
新建终端	Ctrl + Shift + `	Cmd + Shift + `
清屏	`Ctrl + L`	`Cmd + K`

16

新手避坑指南（FAQ）

常见问题与解决方案

Q1

下载很慢或下载失败？ ▼

确认从 trae.cn 下载国内版。如果网络问题，可尝试切换手机热点，或使用下载工具（如 IDM）加速。

Q2

打开 Trae 提示"需要登录"？ ▼

国内版必须登录才能使用 AI 功能。点击右上角登录按钮，使用手机号获取验证码登录。

Q3

下载了国际版（trae.ai）怎么办？ ▼

国际版需要海外网络且登录方式是 Google/GitHub。国内用户建议卸载后重新从 trae.cn 下载国内版。

Q4

AI 生成的代码运行报错？ ▼

这很正常。AI 不是完美的，遇到报错：1. 复制错误信息 2. 粘贴到 Chat 面板 3. 输入"帮我修复这个错误" 4. AI 会自动分析并给出修复方案

Q5

AI 生成的代码不符合我的需求？ ▼

问题大概率出在需求描述不够具体。试试：补充技术栈（"用 React 而不是 Vue"）、补充功能细节（"要支持分页，每页 10 条"）、补充 UI 要求（"深色主题、圆角按钮"）

Q6

SOLO 模式卡住了不动？ ▼

1. 检查终端是否有权限弹窗需要确认 2. 点击「停止」按钮，重新输入需求 3. 复杂需求拆分成小步骤，一步步来

Q7

AI 写的代码有 Bug 怎么办？ ▼

1. 把报错信息发给 Chat："这段代码报错 xxx，请修复" 2. 让 AI 加日志调试 3. 让 AI 写测试："为这个函数生成单元测试"

17

进阶技巧与最佳实践

从会用 to 用得好

📄.traeignore 文件配置

和 .gitignore 类似，告诉 Trae 哪些文件不需要被 AI 索引。

.traeignore

# 依赖目录
node_modules/
vendor/
__pycache__/
.venv/

# 构建产物
dist/
build/
out/

# 大文件
*.zip
*.tar.gz
*.mp4

# 敏感信息
.env
*.pem
*.key

# 日志 & 数据库
*.log
*.db
*.sqlite

🚀 索引速度大幅提升 🎯 AI 只读取相关文件 💰 降低 Token 消耗

✍️需求描述技巧（STAR 法则）

Prompt 模板

【技术栈】明确语言和框架
【功能】列出核心功能点
【UI/UX】描述界面和交互要求
【数据】说明数据来源和格式
【约束】补充性能、安全、兼容等要求

对比示例

❌ 模糊描述

"做一个登录页面"

"写个爬虫"

"做个图表"

✅ 精准描述

"用 React + Formik + Yup 做登录页面，含邮箱/密码输入、表单验证、loading 状态、错误 Toast"

"用 Python Scrapy 写爬虫，抓取电商商品信息存入 MySQL，遵守 robots.txt，请求间隔 2 秒"

"用 ECharts 做实时仪表盘，含折线图/柱状图/饼图，每 5 秒自动刷新"

🧩复杂项目拆分策略

不要一次性让 AI 生成整个大项目，推荐分阶段开发：

阶段 1：搭骨架

路由配置、全局布局、状态管理基础配置、Axios 封装

阶段 2：逐个页面

卡片式布局 → 筛选排序 → 分页 → 交互按钮

阶段 3：后端 API

RESTful 接口、JWT 认证、数据库操作

阶段 4：联调优化

前后端联调、修复接口对接问题、性能优化

🔧终端联动报错修复

终端运行代码报错后，报错信息旁会出现 「🔵 AI 修复」 按钮 → 点击后 Trae 自动抓取错误栈 → AI 分析错误原因并给出修复方案 → 一键应用修复

18

Trae vs 其他工具对比

帮你做出明智选择

对比维度	Trae	Cursor	VS Code + Copilot	Windsurf
价格	🆓 核心免费	💰 $20/月	💰 $10/月起	💰 部分付费
中文支持	⭐⭐⭐⭐⭐	⭐⭐⭐	⭐⭐⭐	⭐⭐⭐
SOLO 全自动	✅ 完整支持	⚠️ 部分支持	❌ 无	⚠️ 部分支持
设计稿转代码	✅ 原生支持	❌ 不支持	❌ 需插件	❌ 不支持
国内生态适配	⭐⭐⭐⭐⭐	⭐⭐	⭐⭐	⭐⭐
内置模型	豆包/DeepSeek/Kimi/GLM	Claude/GPT	GPT 系列	Claude/GPT
MCP 支持	✅ 完整支持	✅ 支持	⚠️ 有限	✅ 支持
学习成本	⭐ 极低	⭐⭐	⭐⭐⭐	⭐⭐

💡

选择建议：
🇨🇳 国内用户首选 Trae：中文好、免费、不用翻墙
💰 预算充足 + 海外用户：Cursor 也不错
🔧 喜欢折腾配置：VS Code + Copilot 灵活度高
🆓 零预算 + 要最强功能：Trae 目前是最优解

19

学习资源与社区

持续学习，持续进步

🔗 官方资源

资源	地址	说明
官网	https://www.trae.cn	下载、文档、更新日志
官方文档	https://docs.trae.cn	完整使用文档
官方论坛	https://forum.trae.cn	用户交流、教程分享
更新公告	https://forum.trae.cn/c/announcements	新功能第一时间了解

🗺️ 学习路径推荐

🔰

第一阶段：上手

1-2 天

安装 Trae，完成初始配置
用 Builder 做一个简单网页
用 Chat 模式问几个编程问题
体验 CUE 代码补全

🌱

第二阶段：熟练

3-7 天

用 SOLO 模式做完整小项目
学会用 @ 和 # 引用上下文
掌握 CUE-Pro 和 Tab to Jump
尝试上传设计稿生成代码

🌳

第三阶段：进阶

1-2 周

创建自定义 Skill
配置 MCP Server
创建自定义智能体
用 SOLO Coder 做复杂项目

🚀

第四阶段：精通

持续

深入理解 Prompt Engineering
多智能体协同开发
企业级项目实践
参与社区分享经验

💬 社区交流

🏛️

Trae 官方论坛

forum.trae.cn — 提问、分享、看教程

📖

稀土掘金

搜索 "Trae" 标签 — 大量实战文章

🐙

GitHub

搜索 awesome-trae — 开源 Skill 和配置

💬

微信公众号

搜索 "Trae IDE" — 官方动态

20

总结

关键要点回顾

传统开发：你写代码 → 你调 Bug → 你配环境 → 你部署 ↓ Trae 开发：你说需求 → AI 写代码 → AI 调 Bug → AI 配环境 → AI 部署

Trae 不是要取代程序员，而是让程序员从重复劳动中解放出来，专注于真正有创造性的工作。

要点	记住这句话
选对模式	学习用 IDE，问答用 Chat，出活用 SOLO
写好需求	越具体越好，技术栈+功能+UI+数据+约束
善用上下文	@文件 #Workspace 让 AI 更懂你的项目
迭代优化	不满意就说，AI 会改到你满意
配置 .traeignore	排除无关文件，提升速度和准确度
复杂项目拆分	分阶段、分模块，一步步来
免费是真免费	核心功能全部免费，放心用

字节跳动 Trae AI 编程工具保姆级完整使用教程

Trae 是什么？

📌产品定位

✨ 核心优势一览

基础功能永久免费

原生中文支持

零配置开箱即用

多种顶级大模型

VS Code 无缝迁移

设计稿转代码

SOLO 全自动开发

MCP 协议扩展

👥 适用人群

零基础小白

在校学生

前端开发者

后端开发者

全栈开发者

产品经理/运营

下载与安装

🖥️Windows 安装步骤

打开浏览器，访问 https://www.trae.cn

双击安装包

可选：自定义安装路径

等待安装完成

🍎macOS 安装步骤

下载对应芯片版本的 .dmg 文件

双击 .dmg 文件打开

打开启动台，找到 Trae 点击启动

🐧Linux 安装步骤

下载对应格式的包

终端执行安装命令

⚙️首次启动初始化配置

第 1 步：选择主题

第 2 步：选择显示语言

第 3 步：导入 VS Code / Cursor 配置（可选）

第 4 步：安装命令行工具（可选）

第 5 步：登录账号

✅验证安装成功

界面详解

左侧栏 - 资源管理器

中间编辑区

右侧 AI 面板

底部面板

🤖 右侧 AI 面板 —— 最核心区域

三大核心开发模式

IDE 模式

Chat 模式

SOLO 模式

📊 三种模式对比

Builder 模式 —— 一句话生成完整项目

🏗️什么是 Builder？

📋 使用步骤

打开 Builder

输入需求描述

等待 AI 生成

预览成果

迭代修改

🔥 实战案例

✅案例 1：待办事项网页

🐍案例 2：贪吃蛇小游戏

🎓案例 3：学生管理系统

Chat 模式 —— 你的随身 AI 编程老师

🛠️ 核心用法

代码解释

Bug 修复

代码优化

生成注释

生成单元测试

API 使用咨询

🎯 上下文引用技巧（@ 和 #）

CUE 智能编程工具

智能代码补全

CUE-Pro 主动触发

Tab to Jump 智能跳转

智能导入

智能重命名

内置智能体（Agent）系统

🤖SOLO Coder 详解

🛠️自定义智能体

字节跳动 Trae AI 编程工具
保姆级完整使用教程