【新手必看】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+

软件准备：

Node.js（下载地址

）

安装后打开CMD输入node -v验证版本（需≥16.0）

Python（下载地址

）

建议安装Python 3.10+版本

浏览器（推荐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

应该看到默认的欢迎页面！

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

修改前端页面

打开src/index.html

将 标签内的文字改为：

html

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

修改后端逻辑

打开app.py

在hello()函数中添加：

python

return "Hello from Python！"

重启服务

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

七、常见问题解答

Q1：启动时报错 "权限不足"

Windows请右键CMD选择【以管理员身份运行】

macOS/Linux请在命令前加sudo

Q2：访问页面空白

检查防火墙是否放行8080端口

确认浏览器没开启隐私模式

Q3：依赖安装失败

尝试更换npm源：

bash

八、下一步学习

你已经成功完成了第一个Trae项目！快去分享给你的技术伙伴吧~

如果有疑问，欢迎在评论区留言，我会第一时间为你解答！

文章声明：本文内容基于Trae官方文档整理，所有操作在Windows 11系统测试通过，其他系统可能存在细微差异。

原创不易，转发请注明出处！