零到全栈 · 卷 3 · 工程化与版本控制
导读
本合集目录
本章目录
本卷目标:把"能跑的三个文件"变成"能交付、能回溯、能回滚的工程"。 读完这一卷,你手里还是同一个「读到」——页面看起来和卷 2 结束时一模一样,但它已经能被 Git 记住每一次改动、被 npm 管住每一个依赖、被 Vite 打成一份可以整包发上服务器的产物。
本文件是卷 3 的导航页。 正式内容在 7 个分册里,每册可单独打开阅读。
一、本卷信息
| 项 | 内容 |
|---|---|
| 卷号 / 卷名 | 卷 3 · 工程化与版本控制 |
| 章数 | 7 章 |
| 组织方式 | 一章一个文件,每章自带前置说明、正文、动手、验收 |
| 主题范围 | ① Git 的三区与快照模型 ② 分支、合并与冲突 ③ 远程仓库与 PR ④ ESM 模块拆分 ⑤ npm 与依赖 ⑥ Vite 的开发与构建 ⑦ 静态产物发布与回滚 |
| 不涉及 | React / Next(卷 4)、后端接口(卷 5)、数据库(卷 6)、域名与 HTTPS(卷 7) |
| 目标读者 | ① 跟着卷 2 写出三个文件、但一改就乱的人 ② 会写代码、没耐心读 Git 原理的人 ③ 能把页面做出来、但发版靠"手工拖文件"的人 |
| 前置条件 | 电脑上已装 Git、Node.js LTS、VS Code(卷 0 第 4 章);能看懂 index.html / styles.css / app.js 三者的分工(卷 2) |
| 产出物 | 一个带完整提交历史的仓库 · 一棵拆开的模块目录 · 一份 npm run build 出来的 dist/ · 一条能上线的发布命令 · 一份能回滚的版本目录 |
| 随书代码 | 本卷不额外发代码包:所有代码都是在卷 2 的 dudao/ 上原地改造,正文给出每一步的完整片段 |
| 验收口径 | 不看"读完了没有",只看能不能用一个命令把线上切回上一版(见第 7 章) |
二、七章目录
| 章 | 文件 | 这一章给你什么 | 产出 |
|---|---|---|---|
| 1 | 卷3-01-Git的心智模型.md | 快照而非差异;三区;HEAD;撤销决策表 | 一个仓库 + 两条提交 |
| 2 | 卷3-02-分支合并与冲突.md | 分支是指针;两种合并;冲突标记怎么读 | 一次真实的冲突与解决 |
| 3 | 卷3-03-GitHub远程与协作.md | 远程跟踪分支;push/pull/fetch;PR;密钥 | 远端仓库 + 一次 PR |
| 4 | 卷3-04-从脚本到模块.md | ESM 的 import/export;模块作用域;file:// 为何不行 | 四个模块 + 本地服务跑通 |
| 5 | 卷3-05-npm与依赖管理.md | package.json、semver、lock、npm ci | 一份可复现的依赖清单 |
| 6 | 卷3-06-Vite开发与构建.md | dev/build/preview;dist;环境变量;base | 一个 dist/ |
| 7 | 卷3-07-把工程发布到公网.md | rsync 发布;Nginx root;403/404/500;回滚 | 一个公网地址 + 一条回滚命令 |
章与章有硬依赖:第 1 章的仓库是第 2、3 章的操作台;第 4 章拆出来的模块是第 6 章 Vite 的输入;第 5 章的 package.json 是第 6 章的地基;第 7 章发布的就是第 6 章的 dist/。中间跳一章,后面就会在"文件从哪来的"上卡住。
三、阅读约定
| 记号 | 含义 |
|---|---|
代码字体 |
命令、文件名、字段名、报错原文;可直接复制 |
| 粗体 | 关键判断,值得单独记一行 |
| ⚠️ | 高频翻车点,跳过会浪费你两小时 |
| 「形如」 | 终端输出因系统/版本略有差异,对得上结构即可,不必逐字相同 |
| 表格 | 凡是需要对比、需要决策的,都在表里 |
本卷有一条和前面不同的规矩:命令按顺序敲,别合并。 卷 2 里写错一行刷新页面就重来;本卷里 git reset --hard 敲错一次,丢的是几个小时的代码。每一节动手前先看一遍"我要改的是哪个区"。
四、本卷与前后各卷的关系
卷2 三个文件(HTML/CSS/JS) —— 页面能用,但没法长大
└ 卷3 工程化(本卷) —— 有历史、有依赖、有构建产物
└ 卷4 React / Next —— 在 dist 之前换成组件与路由
└ 卷5 后端与 API —— 页面开始跟服务器要数据
└ 卷6 数据与状态 —— 数据从 localStorage 搬进 SQLite
└ 卷7 上线运维 —— 域名、HTTPS、日志、备份
本卷最容易出现的误解:以为工程化是"给项目加一堆配置"。不是。工程化解决的是三个具体痛点——
| 痛点 | 卷 2 的状态 | 卷 3 的解法 |
|---|---|---|
| 改坏了想退回 | 靠 app-最终版2.js 这种文件名 |
提交历史 + git restore / git revert |
| 别人(或三个月后的你)接手 | 一个文件里 600 行,函数互相覆盖 | ESM 模块 + 明确的依赖方向 |
| 发版靠手工 | 拖文件、忘了传 CSS、缓存住旧的 | npm run build + 发布脚本 + 版本目录 |
这三件事,卷 4 之后一样都不会消失——只是工具换成 React、换成 Next、换成 systemd。模型在这里建,后面只是换壳。
五、现在开始
如果你只想知道这一卷最终交付什么,先看第 7 章的目录结构图;但不要跳过第 1 章——后面六章所有"救命"的操作,都建立在"工作区 / 暂存区 / 仓库"这三个词上。