12.1 阶段 0 浏览器与工程环境
本页目录
一、阶段定位
本阶段不写业务页面,只解决三件事:把 Node 20 与包管理器装好、把浏览器 DevTools 用到顺手、能用命令行与 Git 把一个工程跑起来。后面每个阶段都会反复用到这些概念——阶段 3 写组件要知道组件挂载在 DOM 树的哪个节点、阶段 5 排查白屏要会看 Network 与 Console、阶段 7 做性能优化要会读 Performance 面板——如果只靠 IDE 点点鼠标,到排障时会完全无从下手。
不掌握本阶段会在后面具体卡在哪:
- 说不清浏览器输入 URL 到像素绘制之间发生了什么,到阶段 7 问「为什么首屏白屏」只能答「加载慢」,说不出关键渲染路径。
- 不会看 DevTools 的 Network 瀑布,接口报错时分不清是请求没发出去、跨域被拦、还是 404/500。
- 没装过 Node、没配过版本管理工具,换一台机器或在 CI 里执行构建时直接报
'node' 不是内部或外部命令。 - 不会用 Git,阶段 5 做工程化、阶段 6 做 SSR 实验时无法回退,改坏了只能手动删文件。
判断自己卡住的标志不是「感觉没学懂」,而是——(1) 让你打开任意一个网页的 DevTools,你只会用 Elements 看样式,不会看 Network 的请求时序、Console 的报错堆栈、Application 的本地存储;(2) 命令行里 node -v 或 npm -v 报错;(3) 改了代码浏览器里不生效,你只能反复硬刷新。出现任一现象,先把本阶段六个模块过一遍再进 阶段 1 HTML、CSS 与现代布局。
二、阶段目标与投入
学完本页,应当能用可观察的行为证明以下能力:
| 能力目标(可验证的行为) | 验证方式 |
|---|---|
能在命令行用 node 执行一个 .js 文件,区分 CommonJS 与 ESM |
不依赖 IDE 在任意目录完成执行 |
| 能打开 DevTools 并使用 Elements / Console / Network / Sources / Application 五个面板 | 能在 Network 里找到一次 XHR/fetch 并查看请求头与响应体 |
| 能画出一次从输入 URL 到页面渲染的关键链路 | 口头或纸上写出 DNS、TCP、请求、HTML 解析、渲染树、布局、绘制 |
| 能用 Git 完成 init / add / commit / 新建分支 | git log 能看到提交,分支切换干净 |
能用 npm/pnpm 初始化一个工程并跑通 dev 脚本 |
本地起一个 Vite 空白页能在浏览器打开 |
| 能配置代理解决国内 npm 拉包慢的问题 | 安装依赖不再长时间卡在 resolve |
建议学时:
- 全职(每天有效学习 4–6 小时):1.5 周,约 30–40 小时。其中浏览器原理与 DevTools 12 小时、Node 与包管理 10 小时、Git 与工程初始化 10 小时、动手实验 8 小时。
- 在职(每天 2 小时、周末补 4 小时):3–4 周,约 35 小时。有其他语言基础的人可把 HTTP 部分压缩到「能讲清请求链路」即可,不用背 RFC 细节。
学时分配:浏览器渲染与 DevTools 25%、HTTP 与网络面板 20%、Node 与包管理 20%、Git 15%、Vite 初始化 10%、排障实验 10%。
三、先修自检
进入本阶段前不需要写过网页,但以下基本操作要会;做不到先用一两天熟悉,否则后面命令行实验会频繁卡壳。
| 先修项 | 合格标准 | 不合格时怎么办 |
|---|---|---|
| 文件与目录操作 | 能在终端里新建、进入、删除目录,看懂绝对路径与相对路径 | 用半天熟悉常用终端命令(见模块 5.4) |
| 安装软件 | 能在本机安装一个程序并找到它的安装目录 | 跟着模块 5.2 的步骤装 Node |
| 英文界面基础 | 能看懂 command not found、404 Not Found、CORS policy 这类报错大意 |
遇到报错先把英文原文记下来再查 |
| 浏览器使用 | 能打开开发者工具(F12 或右键检查) | 模块 5.3 会带你做一遍 |
四、知识地图
「掌握程度」分三档:了解(能查到)、会用(能调通)、能讲清原理(能回答追问)。本阶段大部分知识点到「会用」即可,关键渲染路径与 HTTP 链路要到「能讲清原理」。
| 模块 | 知识点 | 掌握程度 | 对应题库章节 |
|---|---|---|---|
| 浏览器渲染 | 关键渲染路径、DOM/CSSOM、渲染树、布局、绘制、重排重绘 | 能讲清原理 | 03.8 浏览器原理、性能优化与前端安全 |
| DevTools | Elements、Console、Network、Sources、Application、Performance | 会用 | 03.8 浏览器原理、性能优化与前端安全 |
| 网络与 HTTP | TCP/IP、三次握手、HTTP 请求响应结构、状态码、缓存头、CORS | 能讲清原理 | 01.2 计算机网络 |
| Node 与包管理 | Node 20、npm/pnpm、package.json、node_modules、SemVer |
会用 | 纯文本章节:Node.js 运行时(题库 04 后端语言与运行时中 Node 章节) |
| 命令行排障 | 查看端口、查进程、查日志、看构建输出 | 会用 | 01.1 操作系统 |
| Git | init / add / commit / branch / merge、忽略文件 | 会用 | 纯文本章节:通用工程规范 |
| 构建初始化 | Vite 脚手架、dev / build / preview 脚本 |
会用 | 03.6 前端工程化 |
进度管理建议:把这张表打印出来,每完成一个模块把「掌握程度」上调一档;关键渲染路径与 HTTP 链路两项必须能对着白板讲清楚再往下走。《知识点全清单》里对应章节是更细的全量打勾清单。
五、分模块精讲
5.1 关键渲染路径与 DevTools
为什么需要它:前端的所有性能问题最终都落在「浏览器把字节变成像素」这条路径上。不理解它,就解释不了「为什么把 CSS 放 head 里、JS 放 body 末尾」「为什么改一个元素位置会引起整屏闪烁」。
核心机制:
- 浏览器拿到 HTML 字节后,先解析成 DOM 树;遇到 CSS 解析成 CSSOM;两者合并成渲染树(Render Tree)。
- 布局(Layout/Reflow)计算每个节点的几何位置;绘制(Paint)把像素画到图层;合成(Composite)把图层拼成屏幕。
- 重排(Reflow)改变几何属性(宽高、位置、字体)会触发重新布局;重绘(Repaint)只改变颜色等外观不触发布局;合成(如
transform、opacity)不触发布局与绘制,性能最好。 - DevTools 的 Performance 面板录制一次操作,能看到 Scripting、Rendering、Painting 各段耗时;Network 面板看到请求的排队、DNS、TCP、下载、等待时间。
最小可运行示例:
# 用 curl 观察一次请求的完整过程
curl -v http://localhost:5173/
# 输出含:Trying 127.0.0.1:5173...(TCP)、> GET / HTTP/1.1(请求行)、< HTTP/1.1 200(响应行)
# 浏览器里打开 DevTools 后:
# 1. Network 面板刷新页面,按 Size 排序找最大的请求
# 2. Console 面板输入 document.querySelectorAll('div').length 看 DOM 规模
# 3. Performance 面板录制滚动 3 秒,看是否有长任务(Long Task)
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| 改了代码浏览器不更新 | 浏览器强缓存或 HMR 没连上 | 硬刷新 Ctrl+F5,或检查 Vite 是否在运行 |
| Network 里请求一直 pending | 代理配置错误或目标服务没起 | 检查 vite.config 的 server.proxy 与目标端口 |
| Console 报 CORS 错误 | 响应头缺 Access-Control-Allow-Origin |
开发期用 Vite proxy 代理,不是改前端代码 |
面试考法:高频问「从输入 URL 到页面展示发生了什么」「重排与重绘的区别」。要按顺序答:DNS → TCP → 请求 → 响应字节 → 解析 HTML 建 DOM → 解析 CSS 建 CSSOM → 合并渲染树 → 布局 → 绘制 → 合成。追问哪些属性只触发合成。
5.2 Node 与包管理
为什么需要它:现代前端工程离不开 Node——Vite、TypeScript、ESLint、Prettier 全是 Node 程序。没装 Node 或版本不对,npm install 后跑构建会报一堆原生模块编译失败。
核心机制:
- 本路径基线 Node 20 LTS(长期支持版)。用 nvm-windows(Windows)、nvm(macOS/Linux)或 fnm 管理多版本,不要直接装系统包。
- 包管理器选 pnpm(推荐,磁盘省、速度快、依赖隔离好)或 npm(Node 自带,零配置)。Yarn 在老项目里常见。
package.json是工程清单:dependencies(生产依赖)、devDependencies(构建与工具依赖)、scripts(可执行命令)、engines(Node 版本约束)。- SemVer 语义化版本:
主.次.补丁,如5.4.0;^5.4.0允许次与补丁升级,~5.4.0只允许补丁升级。
最小可运行示例:
# 验证安装
node -v # 期望 v20.x
pnpm -v # 期望 9.x(npm install -g pnpm 可全局安装)
# 初始化一个工程
mkdir demo && cd demo
pnpm init
pnpm add vue@3.4
pnpm add -D typescript@5.4 vite@5
# 写一个 hello.mjs(ES 模块)
# 内容:console.log('hello node', process.version)
node hello.mjs
// package.json 最小示例
{
"name": "demo",
"private": true,
"scripts": {
"dev": "vite",
"build": "vite build",
"preview": "vite preview"
},
"engines": { "node": ">=20" }
}
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
'node' 不是内部或外部命令 |
没装 Node 或 PATH 没配 | 用 nvm 装好后重开终端 |
| 安装卡住不动 | 默认 registry 在海外 | pnpm config set registry https://registry.npmmirror.com |
node_modules 体积巨大 |
npm 扁平化依赖 + 重复安装 | 换 pnpm,用硬链接共享 |
| 同事能跑、我跑不起来 | 锁文件不一致 | 删 node_modules 与 lock 文件重装,或统一包管理器 |
面试考法:问「npm 与 pnpm 的区别」「dependencies 与 devDependencies 怎么分」。要答到「pnpm 用内容寻址存储与硬链接,节省磁盘且避免幽灵依赖;devDependencies 是构建期工具,不进生产产物」。
5.3 DevTools 五面板速通
为什么需要它:线上问题一半靠 DevTools 定位。等后端给日志、等运维查服务器,不如 Network 与 Console 先看个大概。
核心机制:
- Elements:查看与实时修改 DOM 树、计算样式(Computed)、盒模型;改样式不刷新页面,调完再回源码改。
- Console:执行表达式、看报错堆栈(点开堆栈跳 Sources 对应行)、
console.table看结构化数据。 - Network:按请求类型过滤(Fetch/XHR、JS、CSS、Img);点开一个请求看 Headers、Payload、Response、Timing(排队、DNS、TCP、TTFB、下载)。
- Sources:打断点(行断点、
debugger语句、DOM 断点、XHR 断点),调试变量作用域。 - Application:Local Storage、Session Storage、IndexedDB、Cookie、Cache;Service Worker 在这里注销。
最小可运行示例:
# 在 Network 面板:
# 1. 勾选 Preserve log(跨页面保留日志)
# 2. 过滤 Fetch/XHR
# 3. 点开任意接口,看 Request Headers 里的 Cookie 与 Authorization
# 在 Console 里:
# document.cookie 读 Cookie
# localStorage.getItem('token') 读本地存储
# performance.now() 高精度时间戳
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| Console 报错但点开堆栈是压缩后的一行 | 生产构建没开 sourcemap | 开发环境调试;生产开启 sourcemap 或用错误监控平台还原 |
| Network 里看不到请求 | 跨域预检被拦或请求根本没发 | 看 Console 的 CORS 报错,或检查 fetch 是否被 catch 吞掉 |
| 修改样式刷新后丢失 | 只在 Elements 里改,没回源码改 | 调满意后回 CSS 文件同步修改 |
面试考法:问「接口报错你怎么排查」。要给顺序:看 Network 请求是否发出 → 看状态码(401/403/404/500)→ 看 Request Payload 与后端期望是否一致 → 看 Response 报错信息 → 不行再看 Console 堆栈。
5.4 命令行排障:端口、进程、日志
为什么需要它:Vite 默认占 5173 端口,起多个项目时经常端口被占;服务起不来时看构建输出比看 IDE 靠谱。
核心机制:
- Windows PowerShell:
Get-NetTCPConnection -LocalPort 5173看端口被谁占;Get-Process node看 Node 进程;Stop-Process -Id <pid>杀进程。 - macOS/Linux:
lsof -i:5173或ss -ltnp | grep 5173;ps aux | grep node;kill <pid>。 - Vite 输出的
Local: http://localhost:5173/表示 dev server 已就绪;出现Port 5173 is in use, trying another one...会自动换端口。
最小可运行示例:
# Windows PowerShell
Get-NetTCPConnection -LocalPort 5173 -State Listen
Get-Process -Id <pid>
Stop-Process -Id <pid>
# 启动 Vite 并看输出
pnpm dev
# 终端会持续输出 HMR 更新信息;Ctrl+C 退出
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
| Port 5173 is in use | 上次 dev server 没退干净 | 杀旧 node 进程或让 Vite 自动换端口 |
| 浏览器打不开 5173 | dev server 还在编译或崩了 | 看终端最后一行输出,报错会停在那里 |
| 改代码 HMR 不生效 | 文件名大小写不一致或保存到了别处 | 确认保存路径与文件扩展名 |
面试考法:问「页面白屏你怎么排查」。给顺序:看 Console 是否有报错 → 看 Network 主文档(index.html)是否 200 → 看 JS bundle 是否加载成功 → 看 JS 是否执行到挂载点。
5.5 Git 基本操作
为什么需要它:从阶段 5 开始代码要可回退。没有版本控制,做实验改坏了只能手动恢复,多人协作时连「谁改的」都查不到。
核心机制:
- 三个区:工作区、暂存区(
git add)、仓库(git commit)。 - 常用命令:
git init、git add .、git commit -m "msg"、git log --oneline、git checkout -b feature/x、git merge feature/x。 .gitignore忽略node_modules/、dist/、.env、日志,不要把依赖与构建产物提交进仓库。
最小可运行示例:
mkdir demo && cd demo
git init
git add .
git commit -m "init vite demo"
git checkout -b feature/counter
# 改代码后
git add .
git commit -m "add counter"
git checkout main
git merge feature/counter
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
git commit 报 Please tell me who you are |
没配用户信息 | git config --global user.name / user.email |
把 node_modules/ 提交进去了 |
缺 .gitignore |
加忽略文件,git rm -r --cached node_modules |
| 合并冲突不知道怎么办 | 同一文件同一行被两边改 | 打开标记文件手动改,再 add、commit |
面试考法:问 git merge 与 rebase 的区别。本阶段答到「merge 保留分叉历史、rebase 把提交搬到目标分支顶端」即可。
5.6 Vite 工程初始化
为什么需要它:阶段 1 起就要写 HTML/CSS/JS,不装构建工具只能写静态文件,无法用 TypeScript、无法热更新。Vite 5 是当前主流脚手架,启动速度快、配置少。
核心机制:
- Vite 开发期用浏览器原生 ESM,不打包,所以启动毫秒级;生产期用 Rollup 打包成压缩产物。
- 模板:
pnpm create vite@latest my-app -- --template vue-ts(或react-ts、vanilla-ts)。 vite.config.ts配置入口、别名(@指向src)、dev server 代理、构建产物目录。
最小可运行示例:
pnpm create vite@latest hello-vite -- --template vue-ts
cd hello-vite
pnpm install
pnpm dev
# 浏览器打开 http://localhost:5173
pnpm build # 产物在 dist/
pnpm preview # 本地预览生产产物
// vite.config.ts 最小代理配置
import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
export default defineConfig({
plugins: [vue()],
server: {
proxy: {
'/api': { target: 'http://localhost:8080', changeOrigin: true }
}
}
})
常见坑:
| 现象 | 原因 | 修法 |
|---|---|---|
起 dev 报 Cannot find module 'vite' |
没装依赖 | pnpm install |
| 代理不生效 | 路径前缀不匹配 | 确认请求路径以 /api 开头,target 末尾不带斜杠 |
| 构建后空白 | 路由用了 history 模式且没配服务器 fallback | 生产服务器配置回退到 index.html,或改用 hash 路由 |
面试考法:问「Vite 为什么启动快」。答到「开发期不打包,直接用浏览器原生 ESM,按需编译请求的模块;生产期才用 Rollup 打包」。
六、分层练习
6.1 复现型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 命令行执行 Node | 不依赖 IDE,node 跑通一个 .mjs 文件 |
能打印 Node 版本 | 0.5 小时 |
| 走一遍 DevTools 五面板 | 打开任意网站,五个面板各操作一次 | 能在 Network 找到一次接口并看 Timing | 1 小时 |
| 用 curl 走一遍请求 | 起一个 Vite 页面,curl 其地址 | -v 输出能读出请求行与状态码 |
1 小时 |
| Git 提交与分支 | init、两次 commit、开分支改一行再合并 | git log --oneline 能看到分叉 |
1 小时 |
| Vite 起一个空白页 | 用模板创建并 dev 打开 | 浏览器能看到默认页,HMR 改一行生效 | 1 小时 |
6.2 改造型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 修一个代理问题 | 故意配错 proxy target 复现 404,再修好 | 能说出报错与配置的因果 | 1 小时 |
| 端口冲突排障 | 起两个 Vite 用同端口,按排障表定位 | 不用重启终端就找到占用进程 | 1 小时 |
| 写 .gitignore | 把 node_modules/、dist/、.env 加入忽略 | git status 干净 |
0.5 小时 |
| 状态码归类 | 抓 5 个真实接口响应,标注状态码与含义 | 401/403/404/500/502 能分清 | 1 小时 |
6.3 设计型
| 练习 | 要求 | 验收标准 | 预计耗时 |
|---|---|---|---|
| 手绘渲染路径图 | 从输入 URL 到像素,标注每一层 | 能讲出 DNS、TCP、DOM/CSSOM、布局、绘制、合成 | 2 小时 |
| 整理自己的排障手册 | 整理 DevTools 与命令行常用命令 | 5 条以上可直接照抄执行 | 2 小时 |
| 选 Node 版本 | 为新项目与老项目分别选 Node 版本并说明理由 | 能说出 LTS 与 odd 版本的选型依据 | 1 小时 |
七、排障表
| 现象 | 可能原因 | 排查步骤 | 解决办法 |
|---|---|---|---|
'node' 不是内部或外部命令 |
Node 未装或 PATH 未配 | node -v;看终端是否新开 |
用 nvm 装好并重开终端 |
'vite' 不是内部或外部命令 |
没装依赖或没在工程目录 | pnpm install;ls node_modules/.bin |
重新 install |
Port 5173 is in use |
旧 dev server 未退净 | Get-NetTCPConnection -LocalPort 5173 |
杀旧进程或换端口 |
| 浏览器看到 502 | dev server 崩了或代理后端没起 | 看终端最后一行报错 | 重启服务,检查后端 |
CORS policy 报错 |
响应头缺允许源 | Network 看响应头 | 用 Vite proxy 代理,后端加 CORS |
| 改代码不生效 | 强缓存或 HMR 断 | 硬刷新;看终端是否打印 HMR 日志 | 重开 dev server |
| 依赖安装卡住 | registry 海外 | 看进度条停在 resolve | 换 npmmirror 镜像 |
| 页面白屏无报错 | JS 挂载点没找到或 bundle 404 | Elements 看挂载节点;Network 看 JS | 确认 #app 存在、路径正确 |
八、出口条件
全部勾选后进入 阶段 1 HTML、CSS 与现代布局。
- [ ] 不依赖 IDE,能在命令行用
node执行一个.mjs文件 - [ ] 能用 DevTools 五面板定位一次接口请求与一次样式问题
- [ ] 能口述从输入 URL 到像素绘制的完整链路,含 DNS、TCP、DOM/CSSOM、布局、绘制
- [ ]
node -v与pnpm -v输出版本一致,registry 已配国内镜像 - [ ] 能用 Git 完成提交、开分支、合并,并写好
.gitignore - [ ] 能用 Vite 起一个项目,dev / build / preview 三个脚本都能跑通
- [ ] 排障表里随机抽三个现象,能在 5 分钟内给出排查路径
自测题:
- 浏览器从拿到 HTML 字节到像素绘制,经过哪些关键步骤?
- 要点:解析 HTML 建 DOM、解析 CSS 建 CSSOM、合并渲染树、布局、绘制、合成。
Connection refused与浏览器看到的502分别说明什么?- 要点:前者是目标端口没有进程监听;后者是 dev server 或网关在、但上游连不上。
- npm 与 pnpm 的依赖安装方式有什么区别?
- 要点:npm 扁平化复制,pnpm 内容寻址 + 硬链接,省磁盘且避免幽灵依赖。
- 改了代码页面不生效,你会按什么顺序排查?
- 要点:硬刷新 → 看终端 HMR 是否打印 → 确认保存路径 → 重启 dev server。
dependencies与devDependencies怎么分?- 要点:运行时需要的库进 dependencies,构建/测试/ lint 工具进 devDependencies。
- Vite 为什么开发期启动比 Webpack 快?
- 要点:开发期不打包,用浏览器原生 ESM 按需编译;生产期才用 Rollup 打包。