适用人群
完全没有计算机基础的用户、第一次使用 IDE/编程工具的用户
你将学到：准备环境、安装与启动、打开或创建项目、与 AI 协作（问答、行内提示、代码片段生成）、预览和常见操作
TRAE 是什么
TRAE 是与 AI 深度集成的现代 IDE（集成开发环境）。你可以像聊天一样描述需求，AI 会在编辑器中给出实时代码建议、生成代码片段，甚至从 0 到 1创建项目所需文件。它也支持传统 IDE 的功能，如项目管理、插件管理、源代码管理（Git）等。
你会用到的几个关键词：
AI 助手
和你对话，解释代码、修复错误、回答问题
行内建议（CUE）
在你输入时，AI 给出实时代码建议，你可以选择接受或忽略
代码片段生成
用自然语言描述需求，自动生成代码段并插入到文件
智能体
跨文件、项目级地自动编写或修改代码
📖 术语解释（通俗版）：
• IDE：像功能更强的记事本，用来写和管理代码
• AI 助手：可聊天的"智能同伴"，能解释、修改、补全代码
• 行内建议（CUE）：打字时自动出现的代码建议，类似输入法联想
• 代码片段：一段可直接使用的代码，像现成的积木
• 智能体：跨文件、项目级地自动写/改代码的能力
使用前准备
需要准备的
- 操作系统：Windows 10/11 或 macOS 10.15 及以上
- 基本电脑技能：会使用键盘鼠标、会打开/保存文件即可
- 网络：建议保持稳定网络以使用 AI 功能
✅ 提示：你不需要懂编程术语，本手册会用通俗语言描述每一步。
安装与启动
1 下载并安装
- 访问 TRAE 官方网站，下载与你的系统匹配的安装包
- 双击安装包，按提示完成安装
2 启动 TRAE
- 点击桌面或开始菜单中的 TRAE 图标启动
- 首次启动会看到主界面：左侧是项目/文件区，中间是代码编辑区
快速上手（10 分钟体验）
下面是一条最简单的路径，帮助你立刻体验 AI 协作：
打开一个空文件夹或已有项目
- 如果你已有项目，选择"打开文件夹"，定位到项目所在目录
- 如果你是零基础，先新建一个空文件夹，例如"我的第一个项目"，然后用 TRAE 打开它
与 AI 助手对话（侧边或行内）
- 在编辑器或侧边对话框中，用自然语言描述你的目标
-
"帮我创建一个显示'Hello, TRAE'的网页。" - AI 会解释要做什么，并生成或修改相应的文件
接受/调整行内建议（CUE）
- 当你在文件中输入时，编辑器可能出现灰色或半透明的建议文本
- 如果符合预期，选择接受；不合适就继续输入或让 AI 修改
生成代码片段
- 直接对 AI 说你想要的功能
-
"生成一个按钮，点击后弹出提示。" - AI 会给出可插入的代码片段与说明
预览或运行
- 如果项目支持预览（例如前端项目），按照 AI 提示运行预览
- 打开浏览器查看效果，确认是否符合需求
核心功能与概念
侧边对话与行内对话
你可以在侧边栏与 AI 对话，也可以在文件内部发起讨论。它们都能理解当前上下文，给出解释或修改建议。
行内实时建议（CUE）
当你输入代码时，AI 会推测你的意图并给出即时建议。你可以一键接受建议，快速完成重复或模板化的操作。
代码片段生成
不清楚怎么写代码时，用自然语言描述要做什么，AI 会生成可用的片段并说明放在哪里。
从 0 到 1 创建项目（智能体）
直接告诉 AI 你想开发的程序，它可以自动规划并创建所需文件与目录结构。你只需逐步确认和迭代。
SOLO 模式（了解即可）
这是一种高度自动化的方式，AI 会主导从需求到测试、预览的全流程。目前处于预约开放阶段，感兴趣可在官网登记。
两条常见工作流
工作流 A：已有项目
快速理解与修改
- 1 打开项目文件夹
- 2 选中一个文件，问 AI："这段代码在做什么？如何加个日志？"
- 3 让 AI 生成修改建议或代码片段，插入并保存
- 4 按提示运行或测试，查看效果
工作流 B：从零开始
逐步搭建
- 1 在一个空文件夹中对 AI 说你的目标（例如"做一个待办清单的网页"）
- 2 让 AI 创建项目结构与核心文件
- 3 按建议逐步完善功能（添加输入框、列表、保存数据）
- 4 运行预览，验证并继续迭代
与 AI 协作的三种常用方式
提问与解释
示例问题：
- "这个错误是什么意思？怎么修复？"
- "这段代码效率如何？有更简单的写法吗？"
指令与改写
示例指令：
- "把这个函数分成更小的步骤，并加上中文注释。"
- "为这段逻辑写一个简单的测试。"
生成与补全
示例需求：
- "写一个读取文本文件并显示前 100 个字符的函数。"
- "生成一个按钮，点击后把输入框的内容清空。"
文件与项目的基本操作
新建/打开文件
在左侧文件区新建文件或打开已有文件
保存
完成修改后保存文件（通常编辑器会提示是否保存）
搜索
按关键词在项目中查找文件或内容
运行/预览
如果项目包含运行脚本（如前端、后端项目），按照 AI 或任务提示启动预览或服务
源代码管理（Git）简述
你可以在 TRAE 中查看改动、提交更改并推送到远程仓库（如 GitHub）。如果你还不熟悉 Git：
改动
当文件被修改时会显示变更
提交
为一组改动写一句说明，保存为一个版本
推送
把你的版本同步到网络上的远程仓库，便于备份或协作
常见问题（FAQ）
看不到 AI 建议怎么办？
确保网络正常；在编辑器中尝试重新输入或与 AI 对话重新触发建议。
预览打不开怎么办？
先确认项目类型是否支持预览；根据 AI 的提示安装依赖或运行开发脚本。
我不懂代码能用吗？
可以。你只需用中文描述目标与问题，AI 会给出分步建议与代码片段。
术语表（超简版）
IDE
集成开发环境，编写和管理代码的工具
AI 助手
和你对话、解释与改写代码的智能功能
CUE（行内建议）
在你输入时出现的自动补全与建议
代码片段生成
AI 根据你的描述自动生成可插入的代码
智能体
跨文件、项目级自动编写与修改代码的能力
SOLO 模式
高度自动化的开发模式，当前可在官网预约
参考与延伸
官方文档
-
TRAE CN 文档《什么是 TRAE？》
https://docs.trae.cn/ide/what-is-trae?_lang=zh
-
更多文档与教程：可在官网文档中心浏览（安装、侧边对话、行内对话、CUE、智能体、项目管理、插件管理、源代码管理等主题）
下一步建议
从零开始
在一个空文件夹中对 AI 说你的目标，照着第 4 章操作 10 分钟即可完成首次体验
打开已有项目
打开你的项目文件夹，用自然语言与 AI 协作，任何不懂的地方都直接提问
在操作过程中，用自然语言持续与 AI 协作，边预览边完善，反复小步改进