下面给你一份从 0 到能干活的 Trae 保姆级教程(安装→配置→界面熟悉→日常用法→进阶技巧→避坑),你跟着一步步做就行,不用迷茫。
一、Trae 是什么(先心里有数)
Trae 是字节出的AI 原生 IDE,可以理解为:VSCode + 超强 AI 写代码/改代码/生成项目。
- 支持中文、免费、国内网络友好
- 内置豆包/DeepSeek 大模型
- 核心:Chat(边写边聊)+ Builder(一句话生成项目)+ 智能补全
二、安装(Windows / macOS)
1)官网下载(认准国内版)
国内官网:trae.com.cn
进去点「下载」,选对应系统:
- Windows:.exe(约 350MB)
- macOS:.dmg
2)Windows 安装步骤
- 双击
Trae-Setup-x64.exe - 安装路径不要选 C 盘(建议 D:\Dev\Trae)
- 勾选:
- 创建桌面快捷方式
- 添加到系统环境变量(很重要)
- 安装完成后重启电脑
3)macOS 安装步骤
- 打开 dmg,把 Trae 拖进 Applications
- 首次启动会提示“无法验证开发者”
- 系统设置 → 安全性与隐私 → 仍要打开
- (可选)终端给权限:
sudo xattr -r -d com.apple.quarantine /Applications/Trae.app
4)安装后验证
打开终端(Win:CMD/PowerShell;Mac:Terminal)
trae --version
能显示版本号 = 成功。
三、首次启动 & 基础配置(最关键一步)
1)启动 & 登录
- 打开 Trae → 选简体中文、暗色/亮色主题(建议暗色)
- 登录:手机号+验证码(国内用户直接用,免费)
2)导入旧配置(如果你用过 VSCode)
启动页点「从 VSCode 导入」→ 自动导入:
- 快捷键
- 常用插件
- 代码风格设置
新手建议导入,上手快。
3)AI 模型选择(决定智商)
打开设置:
- 快捷键:Ctrl+,(Win)/ Cmd+,(Mac)
- 搜索:
Trae > Model Selection
推荐选: - doubao-1.5-pro(中文最强、最稳)
- 或 DeepSeek-V3(代码能力强)
4)常用快捷键配置(必改)
设置 → 键盘快捷方式(或 Ctrl+K → Ctrl+S)
建议绑定:
- 生成代码:Ctrl+Enter
- 注释转代码:Alt+Z
- 打开 AI Chat:Ctrl+Shift+I
四、界面快速熟悉(5 分钟搞懂)
左边(传统 IDE 区):
- 资源管理器:文件目录
- 搜索:全局查找
- Git:版本管理
- 扩展:装插件(同 VSCode)
右边(AI 核心区):
- Chat:跟 AI 聊天、改代码、解释代码
- Builder:一句话生成完整项目(最强功能)
- Preview:前端实时预览
五、日常使用:3 大核心功能(手把手)
✅ 1)智能补全(写代码最常用)
直接开始敲代码,Trae 会自动上下文补全:
- 敲一半函数 → 自动补全参数、返回值
- 写注释
// 遍历数组并打印→ 按 Tab 直接生成代码 - 支持 Python / JS / Java / Go 等
示例(JS):
// 计算两数之和
function add(a, b) {
// 光标放这,按 Tab → AI 自动生成
}
✅ 2)Chat 模式:有问题直接问
- 打开右侧 Chat(Ctrl+Shift+I)
- 可以:
- 选中代码 → 问:“这段啥意思?”“帮我优化”
- 报错 → 把错误贴进去 → “帮我修 bug”
- 中文需求:“写一个判断素数的函数”
✅ 3)Builder 模式:一句话生成整个项目(新手神器)
- 右侧点「Builder」
- 输入中文需求,例如:
- “用 Python 写一个 Todo 命令行工具”
- “用 React + Tailwind 做一个个人主页”
- “写一个 2048 小游戏,网页版”
- 点「生成」→ AI 自动:
- 创建文件夹结构
- 生成所有代码文件
- 安装依赖
- 启动预览(前端)
六、实战小例子(10 分钟跑通)
目标:用 Builder 生成一个Python 简易计算器
- 打开 Trae → 新建文件夹
calc-demo - 右侧 → Builder → 输入:
用 Python 写一个命令行计算器,支持加减乘除,输入 q 退出
- 点生成 → 等待 10–30 秒
- 生成完成后,左侧看到
main.py - 右键 → 运行 → 终端即可使用。
七、推荐设置 & 插件(提升体验)
1)设置里打开
- 自动保存:
文件 → 自动保存 → 延迟 100ms - 字体:推荐
JetBrains Mono(好看、等宽) - 缩进:2 空格(前端)/ 4 空格(Python)
2)必装插件(扩展里搜)
- Chinese (Simplified):全界面中文
- Python:Python 语法支持
- JavaScript and TypeScript:JS/TS 支持
- GitLens:Git 增强(看代码谁改的)
八、常见坑 & 避坑
- 启动慢/卡
- 关闭其他占用内存软件
- 内存至少 8G,推荐 16G
- AI 不生成代码
- 检查网络(国内版不用翻墙)
- 切换模型为 doubao-1.5-pro
- 重启 Trae
- 中文乱码
- 设置 → 搜索
encoding→ 设为UTF-8
- 终端运行报错
- 确认已安装对应语言环境(如 Python、Node.js)
- 右键文件 → 选择正确解释器
九、给迷茫的你:怎么用 Trae 学编程?
别把它当“作弊工具”,把它当超级助教:
- 先自己想思路 → 写个大概
- 不会的地方 → 用 Chat 问:“这个逻辑怎么写?”
- AI 生成后 → 逐行看懂,再自己重写一遍
- 小项目用 Builder 生成 → 拆开看结构 → 模仿写
你现在就能做的事:
- 打开 Trae
- 新建文件夹
- Builder 输入:
用 Python 写一个猜数字小游戏 - 生成后跑起来 → 改一改数字范围 → 你就入门了。
如果你愿意,我可以下一步直接带你做一个完整小项目(比如个人网站/待办 App),一行行教你操作,你要不要我直接给你一个「7 天入门实操计划」?