第6课：第一次发布小工具

先看一张直觉图

先不要急着追求一次成功。

请先看这张图：

这张图想告诉你一件事：

第一次发布不是只点一个按钮，而是检查、发布、记录网址、打开验收。

如果失败，也不是课程失败。

失败时留下日志，下一课就能排查。

开始之前

请把前面几课的卡片拿出来。

你应该已经有：

• 本地/线上区别卡。
• 我的部署路径图。
• 部署方式选择卡。
• 部署配置填写卡。
• 线上环境变量检查表。

这一课不是重新想一遍。

这一课是把前面的准备连起来。

你可以这样理解：

第 1-5 课是在装行李。
第 6 课开始出门。

先看一个小故事

小林终于准备发布“小红书标题助手”。

他很紧张。

他想：

如果第一次失败，是不是说明我不适合做项目？

课程提示：

第一次发布的目标不是证明你很厉害。
第一次发布的目标是得到结果和记录。

小林按顺序检查：

本地能运行。
部署方式已经选好。
构建命令已经填写。
输出目录已经填写。
环境变量已经检查。

然后他在平台上点了发布。

平台显示：

Deployment successful

小林很高兴，准备下课。

再继续问：

公开网址在哪里？
你自己打开了吗？
别人也能打开吗？

小林这才发现：

平台说成功，不等于我已经验收完成。

他把公开网址写进记录表，并自己打开检查。

这才算完成第 6 课。

一、第一次发布只追求最小结果

第一次发布不要追求这些：

• 绑定自己的域名。
• 做登录系统。
• 做支付。
• 做数据迁移。
• 做统计后台。
• 做 SEO。
• 做性能优化。

这些以后可以再说。

第 6 课只追求：

别人能打开我的小工具第一版。

如果功能很朴素，也可以。

如果样式不完美，也可以。

如果还有小问题，也可以先记录。

重要的是：

先让它从本地走到线上。

二、发布前先做 5 项检查

点击发布前，先不要急。

你要检查 5 件事。

检查项	为什么要查
本地项目能运行	本地都跑不起来，不建议直接发布
部署方式已经选择	不同项目走不同路径
部署配置已经填写	平台需要知道怎样安装、构建和输出
环境变量已经检查	本地 .env 不会自动变成线上配置
没有公开真实密钥	API Key、Token、密码不能写进公开地方

这 5 项不是为了麻烦你。

它们是为了减少第一次发布时的混乱。

三、什么是公开网址

公开网址就是别人也能访问的地址。

它可能长这样：

https://my-title-helper.vercel.app
https://my-tool.netlify.app
https://my-tool.example.com

第 1 课讲过：

localhost 不是公开网址。

所以第 6 课得到的网址，不能是：

http://localhost:3000

你要写进记录表的是平台给你的线上地址。

四、preview 地址和 production 地址

有些平台会给你不止一个地址。

你可能会看到：

Preview
Production
Deployment URL
Live URL

这一课不要求你完全理解每个平台的叫法。

你可以先这样记：

名称	大概意思
Preview	预览版本，常用于检查
Production	正式版本，通常是要发给别人用的地址
Deployment URL	这一次发布生成的地址
Live URL	当前可访问的线上地址

如果你不确定发哪个给别人，就问 AI：

这些网址里，哪个最适合作为我第一次记录的公开网址？请说明理由。

五、平台成功不等于验收完成

平台可能会显示：

Success
Ready
Published
Deployment complete

这说明平台那边完成了某件事。

但你还要自己检查：

我能不能打开网址？
页面是否显示正常？
核心按钮能不能点？
如果用了 AI 或 API，功能是否能跑？
换一个浏览器或让别人打开是否正常？

第 6 课先做最小验收。

更完整的验收，第 8 课会专门做。

六、失败也要记录

第一次发布失败很正常。

失败时不要马上让 AI 重写整个项目。

你要先记录：

• 平台显示的错误。
• 构建日志里最关键的报错。
• 当前填写的配置。
• 当前公开网址，如果已经生成。
• 你点击了哪一步。

第 7 课会专门讲：

本地能跑，线上为什么会坏。

所以第 6 课失败时，只需要做到：

我知道失败发生在哪里，并留下了日志。

这也比什么都没记录强。

七、动手练习：发布前红绿灯

请先看 5 个检查项。

请给每一项标颜色：

绿色：已经准备好。
黄色：不确定，要问 AI。
红色：还没准备，先不要发布。

检查项：

检查项	我的颜色
本地项目能运行
部署方式已经选择
部署配置已经填写
环境变量已经检查
没有公开真实密钥

如果有红色，不急着发布。

如果有黄色，先让 Codex 帮你判断。

八、自己动手：填写第一次发布记录表

发布时，请边做边记。

不要等下课后凭记忆补。

发布前检查

检查项	是	否	备注
本地项目能运行
部署方式已经选择
部署配置已经填写
环境变量已经检查
没有公开真实密钥

第一次发布记录表

项目	我的填写
部署平台
项目名称
部署方式
安装命令
构建命令
输出目录
环境变量是否已配置
第一次发布时间
公开网址
我第一次打开网址看到什么
平台是否显示发布成功
我自己是否已经打开检查
如果失败，我复制了哪些日志

给 Codex 的提示词

请把下面这段发给 Codex。

我要第一次发布这个小工具。
请你先根据当前项目和我已经填写的部署配置，陪我一步一步检查：
1. 项目是否能本地运行；
2. package.json 里的命令是否清楚；
3. 部署平台需要填写哪些配置；
4. 哪些环境变量需要先配置；
5. 发布成功后我应该怎样验收。
请每次只给我下一步，不要一次性给太多步骤。

点击发布前，也可以发：

请你先不要改代码。

我准备第一次发布这个小工具。

请根据以下信息帮我做发布前检查：

项目是否能本地运行：
【填写】

部署方式：
【填写】

部署配置：
【填写】

环境变量是否已检查：
【填写】

Git 或项目保存点是否已准备：
【填写】

请告诉我：
1. 现在是否可以尝试第一次发布；
2. 发布前最应该确认的 5 件事；
3. 哪些信息要记录到“第一次发布记录表”；
4. 发布成功后第一步验收是什么；
5. 如果失败，应该先复制哪些日志。

如果你卡在平台某一步，可以发：

请你作为第三册上线陪跑助手。
请一次只给我一步，不要一次给一大串操作。

我的部署平台是：
【填写】

我现在停在这一步：
【填写】

我看到的页面文字或提示是：
【复制】

请告诉我下一步应该做什么。
请不要扩展到域名、服务器、Docker、Nginx、CI/CD。

本课记住

本课目标：得到一个别人可以打开的公开网址。

发布前 5 项检查：

1. 本地能运行。
2. 部署方式已选择。
3. 部署配置已填写。
4. 环境变量已检查。
5. 没有公开真实密钥。

平台成功不等于验收完成。自己打开网址检查，才算进入验收。

本课产出：公开网址 + 第一次发布记录表。

本课小结

这一课不是为了做完美产品。

这一课是让你完成第一次从本地到线上的跨越。

你要记住：

第一次发布可以失败。
但不能没有记录。

如果成功，你要留下公开网址。

如果失败，你要留下日志和当前配置。

这两种结果，都会让下一课更容易继续。

课后任务

请完成 3 件事：

1. 尝试第一次最小发布。
2. 填写“第一次发布记录表”。
3. 把公开网址发给一位朋友或同事，请对方打开一次。

如果没有成功发布，也要提交：

问题	我的记录
失败发生在哪一步
我复制了哪些日志
我下一步准备问 AI 什么

这也是有效记录。

本课最低标准

完成本课，不是看页面是否完美。

最低合格标准是：

他完成了一次发布尝试。
你能写出公开网址，或者写出失败发生在哪一步。
你能提交第一次发布记录表。
他知道平台成功后还要自己打开网址检查。

如果你能完成这四件事，本课就达标。