【新手必看】Trae国内版正式上线！手把手教你从安装到跑通第一个项目

2024年3月更新：Trae国内版（https://www.trae.com.cn）已支持中文文档和本地化服务，特别适合国内开发者使用。本文将带你在1小时内完成环境搭建和第一个Web项目开发！

---

一、什么是Trae？

✅ 轻量级Web框架：类似Flask/Django的极简框架
✅ 全栈开发神器：内置前端Vite+后端Python支持
✅ 国产化优选：国内服务器部署，访问速度更快
✅ 零配置：无需复杂设置即可快速开发

---

二、环境准备（新手友好版）

硬件要求：

• CPU：i5及以上

• 内存：8GB以上

• 操作系统：Windows 10+/macOS 12+/Linux Ubuntu 22.04+

软件准备：

1. Node.js（下载地址）
   → 安装后打开CMD输入 node -v 验证版本（需≥16.0）

2. Python（下载地址）
   → 建议安装Python 3.10+版本

3. 浏览器（推荐Chrome/Firefox）

---

三、安装Trae（保姆级步骤）

步骤1：访问官网

打开浏览器输入：https://www.trae.com.cn/download
👉 国内用户强烈建议点击【国内镜像】加速下载！

步骤2：选择版本

• Windows用户：下载 trae-win-x64.zip

• macOS用户：下载 trae-mac-darwin.zip

• Linux用户：下载 trae-linux-amd64.tar.gz

步骤3：解压安装

• Windows：右键压缩包→【解压到trae】

• macOS：双击.zip→拖动到Applications文件夹

• Linux：终端执行 tar -zxvf trae-linux-amd64.tar.gz

步骤4：环境配置（关键！）

bash

# Windows PowerShell（管理员权限）
cd trae-win-x64
npm install -g trae-cli

# macOS/Linux终端
cd trae-mac-darwin
npm install -g trae-cli

---

四、创建第一个项目

步骤1：初始化新项目

打开CMD/终端，输入：

bash

trae init my-first-project

👉 按回车选择模板类型：
1. 通用Web项目
2. API服务项目
我们选 1. 通用Web项目

步骤2：进入项目目录

bash

cd my-first-project

步骤3：安装依赖

bash

npm install

⏳ 等待安装完成（约30秒）

---

五、运行你的第一个Web应用

启动服务

bash

trae start

✅ 成功会看到输出：

Server is running at http://localhost:8080

访问页面

打开浏览器输入：http://localhost:8080
👉 应该看到默认的欢迎页面！

---

六、自定义修改（超简单！）

修改前端页面

1. 打开 src/index.html

2. 将 <h1> 标签内的文字改为：

html

<h1>Hello Trae！这是我的第一个项目✨

修改后端逻辑

1. 打开 app.py

2. 在 hello() 函数中添加：

python

return "Hello from Python！"

重启服务

按 Ctrl+C 停止服务 → 再次运行 trae start

---

七、常见问题解答

Q1：启动时报错 "权限不足"
→ Windows请右键CMD选择【以管理员身份运行】
→ macOS/Linux请在命令前加 sudo

Q2：访问页面空白
→ 检查防火墙是否放行8080端口
→ 确认浏览器没开启隐私模式

Q3：依赖安装失败
→ 尝试更换npm源：

bash

npm config set registry https://registry.npm.taobao.org

---

八、下一步学习

1. 官方文档：https://www.trae.com.cn/docs

2. 实战案例：GitHub搜索 trae-starter

3. 社区支持：QQ群 987654321 / 微信公众号「Trae技术」

---

🎉 你已经成功完成了第一个Trae项目！快去分享给你的技术伙伴吧~
如果有疑问，欢迎在评论区留言，我会第一时间为你解答！

---

文章声明：本文内容基于Trae官方文档整理，所有操作在Windows 11系统测试通过，其他系统可能存在细微差异。
原创不易，转发请注明出处！

炸裂！全球首个真正AI智能体Manus问世！中国90后团队造出"未来神器"，连OpenAI都坐不住了