第2课：部署到底是什么

把部署理解成从本地项目到公开网址的一条路径，而不是神秘按钮。

先看一张直觉图

先不要急着背概念。

请先看这张图：

这张图想告诉你一件事：

部署不是一下子变出网站，而是让项目经过上传、安装依赖、构建、发布，最后得到公开网址。

本课接下来所有内容，都是围绕这条路径展开。

开始之前

回忆第 1 课。

你现在可能有一个本地地址：

http://localhost:3000

你希望以后有一个公开网址：

https://my-tool.example.com

中间缺的不是一句咒语，而是一段过程。

这段过程，就叫部署。

你可以先用一句大白话理解：

部署 = 把我的项目放到一个别人能访问的地方。

先看一个小故事

小林第 1 课已经知道了：

localhost 不能直接发给朋友用。

于是他问 Codex：

帮我部署。

Codex 回复了一大串内容：

连接 GitHub
安装依赖
设置 build command
配置 output directory
添加 environment variables
trigger deployment
查看 deployment logs

小林更慌了：

我只是想让朋友打开，为什么突然这么多词？

其实这些词都在描述同一条路：

把本地项目交给部署平台。
部署平台把项目整理成线上版本。
平台给你一个公开网址。

这一课先不要求小林真的上线。

这一课只要求他把这条路画出来。

一、部署不是魔法按钮

很多平台会有一个按钮，可能叫：

Deploy
Publish
上线
发布

按钮看起来很简单。

但按钮背后通常在做几件事：

接收你的项目。
安装项目需要的工具包。
按项目说明构建线上版本。
把线上版本放到可以访问的位置。
给你一个公开网址。

所以你以后看到“部署失败”，不要只想：

平台坏了。
AI 写错了。
我不会。

你应该先问：

失败发生在哪一步？

二、部署路径的 6 个步骤

第三册先把部署拆成 6 步。

1. 本地项目

本地项目就是你电脑里的项目文件夹。

它里面可能有：

页面文件。
样式文件。
逻辑文件。
package.json。
图片资源。
.env 配置。
历史记录保存逻辑。

这一步你要确认：

我的项目在自己电脑上能不能运行？

如果本地都跑不起来，不建议急着部署。

2. 上传或连接到部署平台

部署平台需要拿到你的项目。

常见方式有两种：

把项目上传给平台。
把平台连接到保存项目的地方。

第三册不用先记平台名字。

你只要知道：

平台必须先拿到项目，才可能帮你发布。

3. 安装依赖

很多项目不是单独一个文件。

它需要一些工具包才能运行。

第二册里你见过：

npm install
node_modules
dependencies

部署平台拿到项目后，通常也要安装这些依赖。

如果依赖装不对，部署可能会失败。

4. 构建项目

构建听起来很技术。

你可以先理解成：

把开发时的项目整理成线上能使用的版本。

有些项目需要构建。

有些很简单的静态页面可能不需要复杂构建。

这一点不用你自己猜，后面第 4 课会让 Codex 根据 package.json 帮你判断。

5. 发布

发布就是部署平台把构建好的结果放到线上。

这一步成功后，平台通常会给你一个地址。

但注意：

平台显示发布成功，不等于最终验收完成。

你还要打开网址，看页面是否真的正常。

6. 公开网址

公开网址是第三册最重要的阶段成果。

它通常长这样：

https://...

它应该不是：

localhost
127.0.0.1
file://...

拿到公开网址以后，才进入后面的验收和排错。

三、部署平台帮你做什么

部署平台不是万能的。

它通常帮你做这些事：

平台帮你做	你还要提供
接收项目	项目文件或项目仓库
安装依赖	正确的依赖说明
执行构建	正确的构建命令
发布线上版本	正确的输出目录或启动方式
给公开网址	你自己打开并验收
提供日志	你复制日志给 AI 分析

你不需要成为部署专家。

但你要知道平台问你问题时，它不是在刁难你。

平台是在问：

我要怎样把你的项目整理成线上版本？

四、这节课先不做什么

第 2 课不要急着做这些事：

不注册新平台。
不比较很多平台优劣。
不绑定域名。
不买服务器。
不配置 Docker。
不处理复杂数据库。
不追求一次成功上线。

本课只做一件事：

画出我的项目从本地到公开网址的大概路径。

知道路径以后，后面每一课才不会慌。

动手练习：把部署步骤排顺序

请把下面这些步骤排成正确顺序。

发布
本地项目
构建项目
公开网址
安装依赖
上传或连接到部署平台

你的答案：

步骤	我的答案
第 1 步
第 2 步
第 3 步
第 4 步
第 5 步
第 6 步

参考顺序是：

本地项目 -> 上传或连接到部署平台 -> 安装依赖 -> 构建项目 -> 发布 -> 公开网址

自己动手：填写我的部署路径图

请根据你自己的项目，填写这张卡。

问题	我的答案
我的项目现在在哪里
项目需要上传或连接到哪里
部署平台可能要先安装什么
部署平台可能要执行什么构建步骤
发布后我会得到什么
这条路径里我最不懂的一步是

如果你还不知道部署平台，就先写：

还不确定，下一课让 AI 判断。

这不是失败。

第 3 课才会正式选择部署方式。

给 Codex 的提示词

适合场景

你已经知道本地和线上不同，但不知道自己的项目从本地到线上要经过哪些步骤。

复制提示词

请你先不要改代码。

请阅读这个项目，并用小白能听懂的话说明：
1. 如果我要部署这个项目，它从本地到线上大概要经历哪些步骤；
2. 哪些步骤是部署平台会帮我做的；
3. 哪些信息需要我自己提供；
4. 哪些步骤可能失败；
5. 失败时我应该复制哪些信息给你。

请按这个顺序解释：
本地项目 -> 上传或连接平台 -> 安装依赖 -> 构建 -> 发布 -> 公开网址。

使用提醒

如果 Codex 开始推荐一堆平台，先补一句：

这一课先不要比较平台，也不要开始部署。请先帮我画清楚部署路径。

本课记住

部署 = 把项目放到别人能访问的地方。
部署路径：本地项目 -> 上传或连接平台 -> 安装依赖 -> 构建项目 -> 发布 -> 公开网址。
先知道路径，再上平台。

本课小结

这一课只要带走 5 个判断：

部署不是魔法按钮。
部署是一条从本地项目到公开网址的路径。
平台通常会接收项目、安装依赖、构建、发布。
部署失败时，要先判断失败发生在哪一步。
第 2 课只画路径，第 3 课才选择部署方式。

你现在还不需要知道每个按钮怎么点。

你只需要能说出：

我的项目要从哪里出发，经过哪些步骤，最后得到什么。

课后任务

请完成 3 件事：

把“本地项目 -> 上传/连接 -> 安装依赖 -> 构建 -> 发布 -> 公开网址”写一遍。
用自己的话解释“部署不是魔法按钮”。
找出你最不懂的一步，下一课带着这个问题问 Codex。

课后可以写成：

问题	我的答案
我现在最不懂的是	为什么平台要安装依赖 / 什么是构建 / 什么是输出目录 / 平台怎样给我网址

本课最低标准

你做到下面 4 件事，就算本课合格：

能说出部署是把项目放到别人能访问的地方。
能按顺序说出本地项目、上传/连接、安装依赖、构建、发布、公开网址。
能完成“我的部署路径图”。
能说出自己最不懂的一个部署步骤。

如果你还没有真正上线，不影响本课合格。

本课本来就不负责上线。