TRAE 怎么创建项目？上手前先确认这几件事，含完整示例与避坑

在 TRAE 里创建项目，最终要拿到的不是一堆文件，而是一个能跑起来、能回滚、依赖装得上的目录。开始前先确认五件事：目录是否已经纳入 Git、运行时版本是否明确、依赖源是否可达、目录结构有没有先定好、以及你允不允许 AI 直接执行安装命令。本文给出一个最小可跑的示例、三条创建路径的取舍、一段可直接改用的提示词模板，以及升级与排错的边界说明。文中命令结果均标注为预期结果、未在本机执行。

用 TRAE 创建项目上手前先确认这几件事

先看结论

先建仓再开 TRAE。 空目录先 git init 并提交一次空提交，AI 改坏了可以用 git diff 直接回退，这是最低成本的保险。
把运行时版本写死并告诉 AI。 版本不明确是 AI 生成代码最常见的翻车点，它会按"最新版本"写，而你的环境往往不是。
目录结构先定，再让 AI 填内容。 反过来做，你会得到一份不符合你习惯、且难以合并的结构。
依赖安装这一步自己执行。 不要默认让 AI 直接装包，先看清它要装什么、版本存不存在。
敏感代码先确认隐私设置。 公司仓库与密钥文件不要想当然地认为不会离开本机。

一、最小场景与预期行为

这一篇的场景是：你想用 TRAE 从零起一个能跑的最小项目（以 Node 与 Python 两种运行时为例），并且能在生成代码之后自己验证它确实能跑。

预期行为可以拆成四条，逐条对应后面的检查项：

项目目录已经被 Git 跟踪，任何一次 AI 改动都能看到 diff；
运行时版本已知且写进了项目（.nvmrc、runtime.txt 或 pyproject.toml）；
依赖能装上，且装的是你预期的版本；
有一条启动命令能跑通，npm run dev 或 python app.py 二选一即可。

之所以把"能跑"放在第一位，是因为 AI 生成的脚手架看起来完整，但依赖版本、入口文件名、脚本命令这三处最容易与实际环境对不上。看起来完整不等于能跑，这是新手在使用 AI IDE 时最需要建立的判断。

如果你对 TRAE 的界面与基础操作还不熟，可以先跟一遍 TRAE 编程中文教程，再回来按这份清单操作。

二、上手前先确认的 5 件事

1. 目录与版本控制

mkdir trae-demo && cd trae-demo
git init
git commit --allow-empty -m "chore: init"

预期结果：目录下出现 .git，git log 能看到一条初始提交。失败分支是提示 git 不是可识别命令，说明本机没装 Git 或没进 PATH，先装 Git 再来。

2. 运行时版本确认

node -v
npm -v
python -V

预期结果分别输出版本号。把输出的版本号原样写进对话或配置文件，不要写"最新版"。版本差异是硬边界：Node 18 与 Node 22 的模块解析、Python 3.9 与 3.12 的类型语法都不一样，AI 不知道你的实际版本时只能猜。

3. 依赖源可达

npm config get registry
pip config list

预期结果能看到当前使用的源地址。这一步决定了后面依赖安装会不会卡住；如果公司网络需要走内网镜像，提前配置好，比装到一半超时再排查省事得多。

4. 目录结构先定

哪怕只是三行，也先在对话里写清楚：

trae-demo/
├── src/        # 源码
├── tests/      # 测试
└── README.md   # 启动说明

5. 权限与隐私边界

涉及公司代码、密钥文件、客户数据时，先确认你所用 TRAE 版本的隐私与数据处理设置，再决定要不要把整个仓库交给它索引。更稳的做法是：只打开需要改的那个子目录，而不是整仓。

三、三种创建路径与取舍

创建路径	适合场景	代价与注意点
打开已有目录	已有代码，想让 AI 帮忙改	目录最好已纳入 Git，便于回退
克隆仓库后打开	接手他人项目或团队协作	先看 README 与锁文件，别急着装依赖
新建空目录让 AI 生成脚手架	从零开始的练手项目	必须自己验证依赖与启动命令

三种创建项目路径的取舍决策树

这里有一条性能上的取舍值得单独说：仓库越大，索引越慢。新手常犯的错误是把一个几千文件的老仓库整个打开，然后抱怨工具卡顿。正确做法是先建子目录工作区，只把本次要改的部分纳入范围，速度与准确度都会好很多。

四、让 AI 生成脚手架的提示词与验收

提示词的关键是把约束写全，而不是只说"帮我创建一个项目"。可以直接改用下面这段（把括号里的内容替换成你的实际值）：

请在当前目录创建一个最小可运行项目。
技术栈：Node.js，版本 v22.x（以 node -v 实际输出为准）。
目录结构：src/ 放源码，tests/ 放测试，README.md 写启动步骤。
要求：
1. 使用 package.json 管理依赖，不要引入我未指定的框架；
2. 提供 npm run dev 与 npm test 两条脚本；
3. 每个依赖都写明具体版本号，不要写 latest；
4. 若某个包你不确定是否存在，明确说明，不要猜测。

验收要看四个点，缺一个都不要急着继续往下写业务代码：

生成的 package.json 里每个依赖版本是否真实存在（AI 可能写出不存在的包或版本，这是最常见的幻觉）；
npm install 是否装得上；
npm run dev 是否真的起得来；
用 git diff 复看一遍改了哪些文件。

npm install
npm run dev
git status

预期结果：依赖安装无报错，开发服务启动并输出监听地址，git status 里能看到本次改动的文件清单。常见失败分支是 ERESOLVE 依赖冲突或下载超时，前者需要降版本或换包，后者换镜像源重试即可。

AI 生成代码后的四步验收速记卡

如果 TRAE 在执行过程中报错或行为异常，官方文档里的排查思路可以参考 TRAE 问题排查，先看是环境问题还是项目配置问题，再决定要不要重开会话。

总结

创建项目这一步的核心不是"点哪个按钮"，而是建立可回滚、可验证的起点：先 git init 留好退路，明确运行时版本并写进配置，提前确认依赖源可达，先定目录结构再让 AI 填内容，依赖安装自己执行并逐条验收。做到这五点，AI 生成的代码才是"可以接着开发"的脚手架，而不是需要你花半天返工的草稿。

常见问题

Q：TRAE 创建的项目一定要用 Git 吗？

不强制，但强烈建议。AI 生成代码是批量改文件，没有版本控制时你只能靠记忆判断改了什么。一次空提交的成本几乎为零，回退时却能救命。

Q：AI 生成的依赖装不上怎么办？

先分清是版本不存在还是网络问题。版本不存在说明 AI 记错了包或版本，让它换成你确认存在的版本，或者自己去官方源核对；网络问题则换镜像源重试。

Q：为什么我指定了版本，生成的代码还是用了新语法？

因为版本信息没有进入上下文。把 node -v、python -V 的实际输出贴进对话，或写进 .nvmrc、pyproject.toml，让配置文件本身成为约束，比在对话里口头说明更可靠。

Q：可以直接让 AI 执行安装命令吗？

可以，但建议先看清它准备执行什么。安装依赖会改动 package.json 与锁文件，也可能触发脚本执行；先让它输出命令清单，你确认后再执行，是更稳的顺序。

延伸学习

想系统了解 TRAE 的能力边界与实战用法，可以看 Django 后台管理系统这门配套课程。
生成代码后按语言特性逐条核对的习惯，可以参照 C++ 智能指针这篇笔记里的检查思路。
代码生成完先统一格式，能省掉大量无谓 diff，可用 Python代码格式化这个工具。