Trae 新手上手指南：安装、模型选择、Builder 和第一个项目
适用人群
Trae 适合三类用户：想免费体验 AI IDE 的个人开发者，无法稳定使用 Cursor 的国内开发者，以及希望用中文需求快速生成项目原型的产品/前端/全栈开发者。
它不是 VS Code 插件，而是一个独立 IDE。界面、快捷键、插件习惯接近 VS Code，但 AI 能力内置在编辑器里，包括 Chat、Builder、代码补全、项目理解和预览。
国内版和国际版
| 版本 | 访问地址 | 适合人群 | 模型特点 | 价格 |
|---|---|---|---|---|
| 国内版 | trae.com.cn | 中国大陆开发者 | 豆包、DeepSeek、Kimi 等 | 当前免费 |
| 国际版 | trae.ai | 海外用户或英文项目 | Claude、GPT、Gemini 等 | Free / Pro |
国内用户优先下载国内版。它的优势是直连稳定、中文 UI、登录和模型调用都更顺。国际版模型上限更高，但网络、账号和地区限制更多。
安装和初始化
打开 Trae 官网下载安装包后，按系统选择 Windows、macOS 或 Linux 版本。第一次启动时，Trae 会询问是否导入 VS Code / Cursor 配置。
建议直接导入：
- 主题和快捷键可以沿用。
- 常用扩展会尽量兼容。
- ESLint、Prettier、TypeScript 等开发配置更容易保持一致。
- 从 VS Code 迁移过来不需要重新适应编辑器。
如果你担心插件冲突，可以先只导入基础配置，等确认项目能跑后再逐个安装扩展。
模型选择
Trae 国内版通常会提供豆包、DeepSeek、Kimi 等模型。第一次使用不必追求复杂配置，可以按任务类型选择：
| 任务 | 建议模型 |
|---|---|
| 中文需求转代码 | 豆包 |
| 复杂逻辑分析 | DeepSeek |
| 长文本总结和文档理解 | Kimi |
| 前端页面生成 | 豆包或 DeepSeek |
| Bug 定位 | DeepSeek |
日常开发里，模型选择没有绝对答案。更实用的方式是：先用默认模型跑一遍，如果结果不稳定，再换 DeepSeek 或 Kimi 复核。
第一个项目
用 Trae 做第一个项目，不建议直接丢一个很大的需求。更好的方式是从一个小而完整的页面开始。
可以在 Builder 里输入：
生成一个 AI 工具导航网站的首页，包含顶部导航、搜索框、分类卡片、热门工具列表和移动端响应式布局。技术栈使用 Vue 3 + Tailwind CSS，代码结构清晰，组件可复用。
Trae 会尝试生成项目结构、页面组件和样式。如果它一次生成得太大，可以把需求拆成三次：
先生成首页布局和基础组件，不要接后端。
给工具卡片补充 hover 效果、评分、标签和跳转按钮。
检查移动端布局，保证 375px 宽度下卡片不溢出。
这种拆法比一次性要求“做完整网站”更稳定，也更容易检查结果。
Chat 的常用问法
Trae Chat 适合在已有项目里定位问题和改代码。几个好用的问法：
先阅读这个项目的目录结构，告诉我首页、工具详情页和数据来源分别在哪里。
这个页面移动端样式错乱，帮我定位相关组件和 CSS，不要直接修改，先说明原因。
把这个组件拆成更清晰的子组件，保持现有 UI 不变。
根据当前代码风格，给这个页面补一个 FAQ 区块，并更新 SEO description。
注意，不要一上来就让 AI “优化整个项目”。更好的方式是让它先解释结构，再改一个局部，最后跑测试或构建。
Builder 的适用边界
Builder 更适合从零生成项目或页面原型，不适合直接接管大型老项目。
适合 Builder 的任务：
- 生成一个落地页。
- 生成一个管理后台原型。
- 生成一个工具详情页组件。
- 根据截图生成 HTML/CSS。
- 搭一个 demo 项目结构。
不适合一口气交给 Builder 的任务：
- 重构整个生产项目。
- 迁移大型框架版本。
- 修改几十个文件的复杂业务链路。
- 处理涉及数据库、权限、支付的完整生产功能。
复杂任务可以先让 Builder 出原型，再用 Chat 分阶段修正。
常见坑
需求太大
一次性输入“帮我做一个完整 SaaS”通常效果不好。Trae 会生成很多文件，但细节容易失控。建议把需求拆成页面、组件、接口、状态管理、样式几个部分。
没有说明技术栈
如果你不说明技术栈，AI 会按默认习惯生成代码，可能和项目不一致。每次生成前最好写清：Vue / React、Tailwind / UnoCSS、组件库、路由方式、状态管理。
不看 diff 直接接受
AI IDE 生成代码不等于代码已经可上线。每次接受前至少看三点：是否引入不存在的依赖，是否破坏已有组件 API，是否造成移动端溢出。
忘记跑构建
Trae 改完代码后，最好让它跑一次项目已有命令，例如：
pnpm exec nuxi prepare
pnpm build:sitemaps
pnpm build
具体命令要看项目配置，不要机械照搬。
和 Cursor 的衔接
如果你已经在用 Cursor，不需要完全迁移。Trae 可以承担两类任务：
- 国内项目、中文需求、低成本快速生成。
- Cursor 网络不稳定时的备用 AI IDE。
项目里可以保留一份 AI_CONTEXT.md，写清：
项目技术栈：Nuxt 4 + Vue 3 + TypeScript
样式规范：优先使用现有组件和 Tailwind 类
URL 规范：内容页 canonical 使用 .html
修改要求：新增页面必须兼顾移动端，修改后跑构建检查
Trae 和 Cursor 都能读取这类上下文，能减少反复解释项目背景的成本。