下面为你准备一篇 《Trae AI IDE 使用教程（全网最全）》——从安装、界面、核心能力、Prompt 编写、Agent 使用、插件扩展到项目级实践，一文讲透 Trae 的全部功能，真正做到全网最完整、最实用、最深度。
Trae AI IDE 使用教程（全网最全）
Trae 是一款专为开发者打造的 AI 开发集成环境（AI IDE），它不仅能辅助编程，还能管理知识库、构建 AI Workflow、自动生成项目结构、调用 API 代理、自动生成文档，是现代 AI 编程的重要工具。
本文将从 安装 → 功能总览 → Prompt 设计 → Agent 体系 → 工作流 → 项目实战 → 最佳实践 全流程讲透 Trae 的使用方法。
一、Trae 的核心定位
Trae 的核心目标是成为你的：
✔ AI 编程助手
✔ AI 文档工程师
✔ AI 自动化工具
✔ AI 项目管理器
✔ AI Workflow 编排器
✔ Agents 管理中心
一句话总结：
Trae=VSCode + Cursor + ChatGPT + 文档系统 + Workflow Engine 的合体。
二、Trae 的安装方式
Trae 提供以下安装方法：
1. 官方客户端下载（最稳定）
进入官网下载安装最新版：
- Windows 版
- macOS Intel / M1 / M2
- Linux 版
安装后首次启动需要登录（Google 或邮箱）。
2. AppImage / Deb / Dmg 包安装
Linux 示例：
sudo dpkg -i trae-xxxx.deb
sudo apt --fix-broken install
3. 浏览器网页版（无需安装）
可直接登录网页版体验：
- 适合随时快速使用
- 功能不如桌面版完整（桌面版支持本地文件管理、集成运行等）
三、Trae 的界面与基础功能介绍
Trae 的主界面由以下 8 大区域构成：
1. Sidebar（侧边栏）
包含核心模块：
🟦 Projects（项目）
🟩 AI Chat（对话）
🟧 Agents（智能体）
🟪 Workflows（自动化流程）
🟨 Library（知识库）
🟫 Docs（文档）
🟩 Extensions（插件）
2. 编辑区（Editor）
支持：
- Markdown 文档
- 项目代码
- Prompt 编辑
- Workflow Builder
- 模型调用脚本
3. Bottom Panel（底部面板）
包括：
- 执行日志
- Workflow 执行结果
- 模型输出
- Agent 运行记录
4. AI Chat 区域
支持：
- 多轮对话
- 上下文绑定当前项目
- 自动生成代码片段
- 自动搜索项目文件
- 自动 refactor、debug、explain
四、Trae 最重要的能力：AI Chat + 项目联动
Trae 最强的地方是：
AI 可以自动读取你的整个项目，进行智能修改。
例如：
优化这个项目的数据库连接池配置
Trae 会：
- 扫描项目所有代码
- 找出你用的 ORM
- 找到配置文件
- 给出修改方案
- 自动生成 PR-like changes
- 可一键 apply patch
这是普通 ChatGPT 做不到的。
五、Prompt 编写与存储（Prompt Library）
Trae 内置 Prompt Library，你可以：
✔ 保存自己的提示词
✔ 分类管理
✔ 设置系统提示词
✔ 在 Workflows / Agents 中调用
示例：创建一个“写技术文档” Prompt
你是一名专业的技术文档工程师，请以如下格式输出内容：
- 摘要
- 功能说明
- 原理讲解
- 代码示例
- 最佳实践
语言：简体中文
风格：简洁、专业
保存到 Library，即可在任何项目中复用。
六、Agents（智能体）使用教程
Trae 支持创建智能体（Agents），类似 AutoGPT / LangChain Agent，但更简单更易用。
Agent 包含以下组件：
1. Identity（角色设定）
决定 Agent 的人格和能力。
例如：
你是一个专业的 Java Spring Boot 架构师。
2. Tools（工具）
Trae 内置工具包括：
- Web search
- Calculator
- Project Reader（读取项目文件）
- Script Runner（执行 Python/JS）
- API Requester（调用外部 API）
- Code Editor（修改文件）
3. Workflow（流程）
可以给 Agent 绑定特定流程，例如：
- 自动 code review
- 自动格式化项目
- 自动生成文档
Agent 示例：创建一个“项目架构师”
Identity:
一名高级架构师，精通微服务和 Docker。
Tools:
- project_reader
- code_editor
- search
Instructions:
当用户要求重构、优化性能、修 Bug 时，你需要主动检索项目结构并提出建议。
使用方式：
👤：帮我检查项目中的循环依赖问题
🤖：好的，正在扫描……
Trae 会自动阅读全局代码。
七、Workflows（工作流）使用教程
Trae 的 Workflow 是它最强大的功能之一。
可以让 AI 自动化执行一系列任务。
例如：
Workflow 示例：自动生成项目文档
流程：
1. 读取项目所有代码
2. 为每个文件生成注释说明
3. 生成架构图
4. 生成 README.md
5. 输出到 docs/ 目录
每一步都可以调用：
- AI Model
- Shell command
- Python 脚本
- API 请求
- 文件读写
并可视化流程图，非常好用！
八、Trae 与项目开发的深度结合
Trae 可以导入你的项目，支持：
- Java
- Python
- Node.js
- PHP
- Go
- C#
- Vue / React / Next.js
- Flutter
- Ruby on Rails
Trae 的项目功能包括：
1. 全项目搜索（语义搜索）
输入：
找出所有使用 JWT 的代码
AI 会自动定位相关位置。
2. 全项目重构
例如：
将所有 API 返回格式统一成：
{ code, msg, data }
Trae 会：
- 扫描控制器
- 生成 patch
- 提供预览和应用按钮
3. 代码解释 / Debug / 性能分析
例如：
解释这个函数为什么耗时很高
Trae 会读取调用链 + 文件内容 + 上下文分析。
九、Trae 扩展（Extensions）
Trae 支持插件扩展：
- GitHub Integration
- API Client
- Postman Import
- Prompt Marketplace
- Web Explorer
- Model Marketplace
你可以安装：
- Claude
- GPT-4
- GPT-5
- LLaMA
- DeepSeek
支持本地模型（Ollama）。
十、Trae 最佳实践（官方与社区经验）
1. 项目必须使用 Git 管理
Trae 的 patch 功能依赖 Git，强烈建议：
git init
2. 尽量使用“思考型 Prompt”
示例：
请先输出分析，再给出最终答案。
效果显著更好。
3. 善用 Trae 的 Agents
你可以创建：
- 文档写手
- 代码风格专家
- 安全审计专家
- 性能优化专家
- 数据库 SQL 调优 Agent
- Bug 猎人
4. 善用 Workflows 自动化重复工作
如：
- 自动生成接口文档
- 自动生成测试用例
- 自动生成 API Mock
- 自动格式化代码
5. 用 Library 管理 Prompt 体系
长期使用非常重要。
十一、实战：用 Trae 创建一个完整项目（从 0 到 1）
示例：创建一个“任务管理系统 API”
第一步：创建项目
New Project → Node.js Express Template
第二步：AI 自动生成业务模块
添加如下模块：用户、任务、标签
Trae 会自动生成控制器、模型、路由。
第三步：让 Trae 自动生成数据库结构
根据业务模型生成 MySQL 的建表 SQL
第四步：让 Trae 生成单元测试
为所有接口生成 Jest 单元测试
第五步：生成项目文档
生成 README、API 文档、架构说明
Trae 会自动写 Markdown 文档。
十二、总结：Trae 怎么用最强？
一句话：
用 Trae 做 AI 驱动的全流程开发，而不是当聊天工具。
✔ 用 Agents 执行专业任务
✔ 用 Workflows 自动化重复工作
✔ 用 AI Chat 完成代码编写与重构
✔ 用项目模式让 AI 理解整个代码仓库