从空白文件夹,到第一个作品

下面这条路径会带你完成一个「校园二手书」页面。每一步都有明确目标、可直接复制的提示词,以及怎样算完成的判断标准。 建议真的打开 Trae,一边读一边做。

6 个步骤 零基础可跟 原生 HTML / CSS / JS
01

目标 · 装好 Trae,能正常打开一个文件夹

准备你的工作台

从 Trae 官方网站下载对应系统的安装包,按提示完成安装。首次打开需要登录账号, 然后选择一个浅色主题——学习阶段,浅色背景看代码更轻松。

  • 访问官网下载页,选择 Windows 或 macOS 版本。
  • 安装完成后登录,允许必要的本地文件访问权限。
  • 在设置里确认界面语言、字体大小与自动保存已开启。
  • 如果使用国内版或国际版,请注意两者账号与模型可能不同。
小提醒 不要一上来就打开重要的项目。先用一个空文件夹练习,弄坏了也不心疼。
02

目标 · 建立一个干净的项目目录

新建项目文件夹

在桌面或文档目录里新建一个文件夹,例如 my-first-site, 然后在 Trae 中选择「打开文件夹」。左侧文件树里出现这个空目录,就说明工作台准备好了。

推荐结构

my-first-site/
├─ index.html
├─ assets/css/style.css
├─ assets/js/main.js
└─ assets/images/

为什么先建结构

结构清晰,智能体才知道新文件该放哪里;后续新增页面、图片也更不容易乱。

你也可以直接让智能体帮你建:新建一个空白文件后,在对话里说 「按上面的结构初始化这个项目,先创建空文件即可」。记得看清它准备创建哪些文件,再确认。

03

目标 · 完成第一次有效对话

先让它读懂项目,再让它动手

打开对话面板,第一条消息不要急着让它写代码。先让它读结构、做复述, 你能立刻判断它有没有理解错。

# 第一条消息:建立共同认知
这是我的第一个练习项目,目前是空文件夹。
我打算做一个静态的「校园二手书」页面,只用原生
HTML / CSS / JavaScript。

请先告诉我:
1. 你会建议怎样的文件结构?
2. 第一步应该先写哪个文件?
先不要创建文件。

看完它的回答,再让它开始。接下来这一步,重点是观察它引用了哪些文件、准备改哪里, 而不是只看最终效果。

好习惯 每次让它改代码前,先看一眼它列出的文件清单。不在清单里的文件,理论上不应该被改动。
04

目标 · 用 Builder 生成一个完整页面

把需求写完整,然后交给 Builder

现在把下面这段提示词复制到 Builder。它包含目标、风格、结构、约束和验收标准, 是一条比较完整的「可执行需求」。

# 目标
创建一个校园二手书页面 index.html,配套样式放在
assets/css/style.css,交互放在 assets/js/main.js。

# 风格
小清新、文艺、安静。米白底色,雾绿与浅粉作为点缀,
标题使用宋体,正文使用无衬线字体,圆角柔和,
不要使用深色背景和高饱和色。

# 页面结构
1. 顶部导航:站名 + 三个锚点链接
2. 首屏:一句主标题、一句说明、两个按钮
3. 书籍列表:6 张卡片,包含书名、价格、成色、联系方式
4. 页脚:一句版权说明

# 约束
- 只用原生 HTML / CSS / JavaScript
- 不引入任何框架与外部字体
- 卡片使用 CSS Grid,桌面三列、手机单列
- 代码加上简短中文注释

# 验收
- 浏览器直接打开即可显示,无需构建
- 手机宽度下不出现横向滚动
- 控制台无报错
- 文件名与上面一致

请先给出文件规划,确认后再生成。

生成完成后,先别急着继续提要求。打开预览,按下面的清单快速过一遍:

  • 页面能打开吗?样式有没有加载?
  • 三列在桌面端是否成立,缩窄窗口会不会挤坏?
  • 六张卡片的信息是否齐全、文案是否合理?
  • 浏览器控制台有没有红色报错?
预期结果 你会得到一个可以直接在浏览器打开的静态页面,结构清楚、配色统一,虽然还谈不上精致,但已经是一个完整的作品。
05

目标 · 学会用「具体差异」来迭代

像编辑一样提修改意见

第一版一定不完美。迭代的关键不是「再好看一点」,而是指出具体位置、具体差异、具体期望。 下面三条可以直接套用。

# 调整视觉
首屏标题和正文的间距太大了,把 .hero 的下内边距
从 64px 改成 40px;按钮圆角改为 999px。其他不动。

# 新增交互
在书籍列表上方加一个搜索框,输入关键词时按书名过滤卡片,
没有结果时显示「暂时没有找到这本书」。
只改 #assets/js/main.js 和列表区的 HTML,样式沿用现有风格。

# 修复问题
在 375px 宽度下,卡片右侧被裁掉了一部分。
请检查 .book-grid 的列宽和 padding,给出最小改动修复,
不要重写整个样式文件。

每一轮都做三件事

  • 看改动:让它说明改了哪些文件、哪些选择器。
  • 看效果:自己打开预览,而不是只看它的文字总结。
  • 留节点:这一轮满意,就提交一次版本(会用 Git 的话)。
低效

「还是不太好看,再改改」

它只能猜你的审美,多轮之后页面会越来越杂。

高效

「卡片阴影太重,从 0 18px 改到 0 8px」

有对象、有数值、有范围,一轮就能到位。

06

目标 · 让智能体记住你的项目约定

写一份项目规则

每次都要重复「用原生 JS」「不要加依赖」很累。把这些约定写进项目规则文件, 之后它在这个项目里就会自动遵守。常见位置是项目根目录下的 .trae/rules/project_rules.md(以你当前版本为准)。

# 项目规则 · 校园二手书

## 技术约定
- 只使用原生 HTML / CSS / JavaScript,不引入框架
- 不新增第三方依赖,不使用外部字体与图标库
- 所有页面共用 assets/css/style.css

## 风格约定
- 主色 #4f7a64,背景 #fbfaf5,点缀 #f2d9d3
- 标题使用衬线字体,正文使用无衬线字体
- 圆角统一 16–22px,阴影要轻

## 代码约定
- CSS 类名使用小写加连字符,例如 .book-grid
- JavaScript 使用 const / let,不使用 var
- 每段关键逻辑上方写一句中文注释

## 行为约定
- 修改前先说明会动哪些文件
- 不删除未提及的文件
- 完成后列出改动清单

如果你已经安装了 MCP 服务,也可以在这里补一条「需要查资料时优先使用哪个工具」。 规则不是越长约好,把你被坑过的点写进去就够了。

规则也会过时 项目换技术栈、换风格时,记得同步更新规则文件,否则智能体会一直按旧约定做事。

Prompt Builder

把你的需求,拼成一条清楚的提示词

填几个空,右边会实时生成一段可以直接粘贴给 Trae 的话。生成后还可以自己再改。

生成结果

            

提示:把「验收标准」写得越具体,返工的次数越少。

Checklist

作品完成前,逐条对一遍

勾选状态会保存在本地浏览器里,下次打开还在。

Quick Quiz

三道题,看看有没有真的理解

选一个答案,系统会立刻告诉你对错。

1. 智能体与普通聊天机器人最本质的区别是什么?

2. 想让 Trae 改一个区块的样式,下面哪种说法最有效?

3. 生成结果不符合预期时,第一步应该做什么?

Troubleshooting

新手最常卡住的四个地方

它改了太多文件

先暂停,要求它列出改动清单并说明原因。之后在提示词里明确「只允许修改 X 文件」。

预览是空白的

检查文件路径、样式表链接和控制台报错。把报错原文直接贴给它,比描述「打不开」有效得多。

改了但页面没变化

可能是缓存或打开了旧文件。刷新预览、确认文件保存位置,再让它核对实际写入的内容。

越改越乱

回到上一个可用的版本,把需求拆成更小的步骤。不要在一个已经混乱的版本上继续叠改动。

做完之后,去资源库收点工具

那里有可以直接复制的提示词模板、术语表,以及新手最常见的问题解答。

打开资源库