定位:从"会用电脑"出发,把第一个真正的全栈产品从本地跑到公网、并且能维护、能迭代。
读者前提:会装软件、会找文件、会上网。不需要任何编程基础。
规模:9 卷 · 63 章 + 6 个附录
日期:2026-11-17 | 本文只管内容体系
一、这份教程的取材原则
先说清楚编写口径,避免读着读着产生误解:
| 项 |
说明 |
| 顺序原则 |
先直觉(电脑 / 终端 / 网络),再前端,再工程化,再框架,再后端,再数据,最后上线。不按技术热度排,按"什么时候用得上"排 |
| 深度原则 |
每一章必须写三层:原理层(为什么必须这样)、故障层(换个环境会怎么坏)、验收层(怎么确认真的成了)。只写"这样能跑通"的章节不收 |
| 项目原则 |
全书一条主线项目贯穿到底,每卷在上一卷的产物上改造,不造一次性玩具 |
| 边界原则 |
不写课程营销、邀请码、平台推广;不搬运任何付费或私有素材;不推荐来路不明的"一键安装包" |
| 版本原则 |
只用官方稳定版写法,不写随机版本号;正文里的每一段代码都必须在真实环境跑通过才落笔 |
| 诚实原则 |
做不到的不写。涉及备案、付费、地区限制的地方直说约束,不假装人人可复现 |
一句话:能跑通、能排错、能验收,三样缺一不算写完。
二、知识地图:能力带与章节归位
63 章不是按知识点平铺的,而是按能力带组织——每一卷交出一层能力,下一卷必然用到它。
| 能力带 |
覆盖章节 |
学完能做什么 |
| 定位与路线 |
0.1–0.5 |
知道自己要学什么、卡住时该往哪一层查 |
| 机器与网络直觉 |
1.1–1.6 |
在自己的电脑和一台云服务器上自由操作,把文件送上公网 |
| 浏览器三件套 |
2.1–2.7 |
不靠框架手写出可用页面,并看懂三类首次报错 |
| 工程化 |
3.1–3.7 |
用 Git 管版本、用 npm 管依赖、用构建工具交付产物 |
| 框架 |
4.1–4.8 |
用组件与路由组织界面,并知道两种上线方式的取舍 |
| 后端与接口 |
5.1–5.8 |
设计并实现接口,能独立完成前后端联调 |
| 数据与状态 |
6.1–6.8 |
把数据存住、把用户分开、把越权堵住 |
| 上线与运维 |
7.1–7.8 |
域名、HTTPS、常驻进程、日志、备份、回滚全链路 |
| 产品化 |
8.1–8.6 |
收敛需求、写测试、做安全与性能、把项目讲清楚 |
容易被跳过、但必须写透的 12 个难点(本书专门给它们留了位置):
| 难点 |
在哪一章 |
为什么容易漏 |
| 路径与编码 |
1.1 |
看起来太基础,实际是新手第一大隐形故障源 |
| 端口与监听地址 |
1.4 / 0.3 |
"本机正常、外面连不上"九成出在这里 |
| 盒模型与布局体系 |
2.2–2.3 |
教程常只给样式片段,不给布局决策依据 |
| 作用域与闭包 |
2.4 |
讲语法容易,讲清"为什么会拿到旧值"难 |
| 事件循环与异步 |
2.6 |
顺序错乱的根因,不写就只能靠猜 |
| MIME / 404 / CORS 三兄弟 |
2.7 |
三种报错长得像"页面坏了",处理方式完全不同 |
| 撤销三板斧 |
3.1–3.2 |
restore / reset / revert 用错会丢代码 |
| 依赖与 semver |
3.5 |
lock 文件的作用几乎没人讲透 |
| 副作用与竞态 |
4.4 |
React 里最难的一类 bug |
| HTTP 报文字段 |
5.2 |
只会调 API 不会读报文,联调永远被动 |
| 预检与凭据 |
5.7 |
withCredentials 的坑一踩一个准 |
| 越权(IDOR) |
6.7 |
功能全对、数据全泄,最典型的"能跑但不安全" |
结构自查:9 个能力带覆盖 63 章,12 个高频难点各有专章或专节承接,无悬空章节、无重复主题。
三、项目主线:「读到」
选一个贯穿全程的项目,比每章造一个玩具强。本版用 「读到」(DuDao):
一个个人知识小站:把网页/PDF 里的摘录存进来,按标签归档,对文本做关键词与情感分析,支持多用户各自登录、只看自己的记录。
为什么选它:
| 理由 |
说明 |
| 每层都能用上 |
有前端页面、有 API、有数据库、有会话、有上线 |
| 复杂度可控 |
不做支付、不做实时通信,避免引入无关复杂度 |
| 与科研场景贴合 |
摘录 + 归档 + 文本分析,正是做研究的人天天干的事 |
| 能自然长大 |
从 3 个静态页 → React 组件 → Next 路由 → API → 库 → 多用户,每一步都是"真需求"逼出来的改造 |
九个阶段的形态(这就是全书的路标):
| 卷 |
项目形态 |
你手里多了什么 |
| 0 |
无 |
一张地图、一个环境 |
| 1 |
一个静态 HTML,能在公网打开 |
终端、SSH、Nginx 默认站 |
| 2 |
三个文件(HTML/CSS/JS)的可用页面 |
浏览器三件套 |
| 3 |
模块化 + Git + Vite 的工程 |
版本管理、依赖、构建 |
| 4 |
React 组件 + Next 路由 |
组件化、状态、路由 |
| 5 |
前后端分离,能存能读 |
HTTP、FastAPI、联调 |
| 6 |
SQLite + 多用户会话 |
数据、SQL、鉴权 |
| 7 |
域名 + HTTPS + 日志 + 备份 |
真正的线上服务 |
| 8 |
能迭代的产品 |
测试、性能、安全、协作 |
四、全书章节清单
卷 0 · 起点与路线(5 章)
| 章 |
标题 |
一句话要点 |
| 0.1 |
这门课到底在教什么 |
三层目标:能交付 / 能定位 / 能与 AI 协作;以及它不教什么 |
| 0.2 |
全栈到底指什么 |
前端、后端、数据、运维四层能力矩阵 + 你不需要全精 |
| 0.3 |
全景地图:一次请求的旅程 |
输入网址到看到页面,中间过了几台机器、几个协议 |
| 0.4 |
课前准备:机器、工具、账号 |
三系统并行;最低配置;六个必注册账号 |
| 0.5 |
收口:12 项自检与路径分叉 |
判断自己该直行、该补基础、还是该直奔项目 |
卷 1 · 电脑与命令行直觉(6 章)
| 章 |
标题 |
要点 |
| 1.1 |
文件、目录与路径 |
绝对/相对/家目录;扩展名不是身份;三个高频翻车 |
| 1.2 |
终端:另一种和电脑说话的方式 |
pwd/ls/cd/mkdir/touch/cat/rm;"先看在哪,再动手" |
| 1.3 |
编辑器与项目 |
VS Code 打开文件夹;工作区、搜索、终端内嵌 |
| 1.4 |
IP、端口、DNS |
一次访问的三个问题:找哪台机器、哪个门、叫什么名 |
| 1.5 |
租一台云服务器 |
安全组、SSH 密钥、apt、没有图形界面怎么活 |
| 1.6 |
让世界看到你的文件 |
Nginx 默认站 → 换成自己的目录 → 第一个公网 200 |
卷 2 · 浏览器三件套(7 章)
| 章 |
标题 |
要点 |
| 2.1 |
HTML:结构就是语义 |
标签、层级、表单、可访问性最低要求 |
| 2.2 |
CSS:盒子、流与布局 |
盒模型、display、Flex 与 Grid 各管什么 |
| 2.3 |
CSS 工程化与响应式 |
变量、层叠与优先级、媒体查询、移动优先 |
| 2.4 |
JS:值、作用域、函数 |
类型陷阱、var/let/const、闭包一次讲清 |
| 2.5 |
JS 与页面:DOM 与事件 |
选择、修改、事件委托、渲染时机 |
| 2.6 |
异步:fetch 与 Promise |
事件循环、async/await、错误与超时 |
| 2.7 |
拆成三个文件,然后撞墙 |
拆分收益;404 / MIME / CORS 三类首次报错 |
卷 3 · 工程化与版本控制(7 章)
| 章 |
标题 |
要点 |
| 3.1 |
Git 的心智模型 |
工作区/暂存区/仓库;提交是一条快照链 |
| 3.2 |
分支、合并、冲突 |
分支不是复制目录;冲突怎么读、怎么收 |
| 3.3 |
GitHub:远程与协作 |
SSH 配置、push/pull、PR 与 Code Review |
| 3.4 |
从脚本到模块 |
ESM 的 import/export;为什么 file:// 跑不通 |
| 3.5 |
npm 与依赖管理 |
package.json / lock / semver;node_modules 为何不提交 |
| 3.6 |
Vite:开发与构建 |
dev/build/preview 三态;环境变量的注入规则 |
| 3.7 |
把工程发布到公网 |
git pull + Nginx root;403/404 怎么分 |
卷 4 · React 与 Next.js(8 章)
| 章 |
标题 |
要点 |
| 4.1 |
为什么需要框架 |
手写 DOM 的三笔债:状态、复用、路由 |
| 4.2 |
组件、props 与 JSX |
组件是函数;props 单向流;列表与 key |
| 4.3 |
状态与受控组件 |
useState、批处理、不可变更新 |
| 4.4 |
副作用与数据获取 |
useEffect 依赖、清理、竞态与 AbortController |
| 4.5 |
路由与页面组织 |
SPA 路由原理;URL 即状态 |
| 4.6 |
Next.js:App Router |
layout/page、服务端组件、文件夹即路由 |
| 4.7 |
数据获取、缓存与环境变量 |
服务端取数、缓存语义、NEXT_PUBLIC 的边界 |
| 4.8 |
两种上线方式 |
常驻 node 服务 vs 静态导出;成本与能力对照 |
卷 5 · 后端与 API(8 章)
| 章 |
标题 |
要点 |
| 5.1 |
API 是什么 |
契约、版本、幂等;为什么 AI 时代人人调 API |
| 5.2 |
HTTP 报文解剖 |
方法/状态码/头/体;curl -v 与 F12 对照 |
| 5.3 |
Python 与虚拟环境 |
venv 原理、pip、requirements、装不上的三种原因 |
| 5.4 |
手搓一个 HTTP 服务 |
标准库写 30 行,看清框架替你做了什么 |
| 5.5 |
FastAPI:路由、校验、文档 |
类型即校验;Pydantic;自动 OpenAPI |
| 5.6 |
错误处理与日志 |
统一响应结构;异常分层;日志该记什么不该记什么 |
| 5.7 |
CORS 与预检 |
跨源三要素;预检两次请求;withCredentials 的坑 |
| 5.8 |
联调收口 |
.env、代理、契约对齐、上线前检查表 |
卷 6 · 数据与状态(8 章)
| 章 |
标题 |
要点 |
| 6.1 |
数据存在哪儿 |
内存/文件/SQLite/服务式数据库的边界与迁移成本 |
| 6.2 |
表与 SQL 基础 |
建表、增删改查、JOIN、聚合 |
| 6.3 |
SQLite 实战与注入 |
连接、参数化、索引、EXPLAIN |
| 6.4 |
分层重构 |
router/service/storage 三层;让换库只改一层 |
| 6.5 |
事务、并发与迁移 |
事务边界;写锁;表结构演进怎么做 |
| 6.6 |
状态与会话 |
cookie/session/JWT 三者取舍;HttpOnly/SameSite |
| 6.7 |
多用户与鉴权 |
注册登录、密码哈希、越权(IDOR)与修法 |
| 6.8 |
收口:数据不丢、越权不进 |
备份、校验、失败演练 |
卷 7 · 上线与运维(8 章)
| 章 |
标题 |
要点 |
| 7.1 |
部署心智:配置与代码分离 |
环境变量、.env.example、密钥不进仓库 |
| 7.2 |
服务器环境准备 |
Python/Node 版本、依赖、目录规划、非 root 运行 |
| 7.3 |
systemd 让进程常驻 |
service 文件逐行讲、日志、开机自启、崩溃重启 |
| 7.4 |
Nginx 反向代理 |
静态托管与反代的分工、头透传、超时 |
| 7.5 |
域名、备案、DNS |
A/CNAME 记录、生效与验证、备案的现实约束 |
| 7.6 |
HTTPS 与证书 |
TLS 握手、Let's Encrypt、自动续期、混合内容 |
| 7.7 |
日志、埋点与流量 |
一行日志八个字段;机器人识别;最小可用埋点 |
| 7.8 |
备份、监控与回滚 |
备份三二一、健康检查、发布回滚脚本 |
卷 8 · 从作品到产品(6 章)
| 章 |
标题 |
要点 |
| 8.1 |
需求收敛与 MVP |
砍到只剩一条主线;什么先不做 |
| 8.2 |
测试三层 |
单测/接口测/端到端;测什么最划算 |
| 8.3 |
性能与缓存 |
gzip、缓存头、图片、索引、懒加载 |
| 8.4 |
安全清单 |
常见十类风险与最小防护动作 |
| 8.5 |
迭代与协作 |
issue、提交信息、发布节奏、变更记录 |
| 8.6 |
结课:把项目讲清楚 |
README、演示路径、复盘模板 |
附录
| 附录 |
内容 |
| A |
命令行速查(文件/权限/进程/网络) |
| B |
HTTP 状态码与常见错误对照 |
| C |
Git 急救手册(撤销、找回、改历史) |
| D |
Nginx 配置模板(静态站 / 反代 / HTTPS) |
| E |
术语表(120 条,每条含"常见误用") |
| F |
自测题库 100 题(按卷分组,附答案要点) |
五、体例(每章统一)
| 项 |
规定 |
| 路径 |
零到全栈/卷N/卷N-MM-章标题.md;导读 卷N-00-导读.md |
| 章首 |
一句话单册说明 + 六行信息表(所属卷 / 前置 / 产出 / 代码 / 配图 / 读完判定) |
| 正文 |
主结构 4 节 ## N.M.K:① 一句话结论 + 一个真实失败场景 ② 原理与方法(表格化) ③ 动手(可抄的命令/代码/配置) ④ 三个坑(症状→成因→修法);入口卷可增 1 节「跑一遍」 |
| 章尾 |
本章验收(可勾选 4–6 条)+ 自测 3 题(<details> 折叠答案)+ 下一步跳转 |
| 硬指标 |
正文 2,500–4,000 汉字(卷 0 为入口卷,1,400–2,100 字);≥2 张有信息量的表;关键章 ≥1 个完整可运行代码块;单段 ≤5 行 |
| 代码 |
只用官方稳定版写法,不写随机版本号;能跑通才写进正文 |
六、学习路径(三条,按起点分)
| 起点 |
建议路径 |
预计投入 |
| 完全零基础 |
卷 0 → 1 → 2 → 3 → 4 → 5 → 6 → 7 → 8,顺序读 |
最长,但每卷都能独立产出东西 |
| 会 Python,不懂前端 |
卷 0(只读 0.3、0.5)→ 2 → 3.4–3.6 → 4 → 5.5 起 → 6 → 7 |
可跳过 1.1–1.3 与 5.3 |
| 会前端,想补后端与上线 |
卷 0(0.3)→ 5 → 6 → 7 → 8,回头补 3.1–3.3 |
最短,但卷 7 决定成败 |
共同底线:卷 7 不能跳。前六卷做出来的东西只在你自己电脑上,卷 7 之后它才属于互联网。
七、全稿目录与阅读入口
全书已完稿:9 卷 63 章 + 导读 9 篇 + 附录 6 篇,正文约 26 万汉字。
三种读法(对应第六节的三条路径):
- 零基础:从 卷0-00-导读.md 开始,一卷一卷顺序读,每章末尾的验收逐条勾完再走。
- 查问题:直接进 附录-00-索引.md——看报错查附录 B,忘记命令查附录 A,仓库乱了查附录 C。
- 复习/自测:附录F-自测题库.md 100 题,答不出的题按"补课"回对应章节。
卷 0 随书代码在 卷0/code/:环境自检、最小静态服务器、首个页面,零第三方依赖,可直接运行。