Critical CSS自动化内联需构建时提取首屏必需样式并注入HTML,主流工具为critical CLI或Webpack/Vite插件,须模拟真实设备与JS渲染时机,控制体积≤1KB且移除冗余link标签。

用 critical 提取并注入关键 CSS
真正能落地的自动化内联,不是手写 <style></style>,而是靠构建时提取首屏必需样式、再注入 HTML。主流工具是 critical(Node.js CLI 或 Webpack/Vite 插件),它会启动无头浏览器,模拟真实首屏渲染路径,抓取匹配的 CSS 规则。
常见错误现象:本地跑 critical 用桌面 UA 渲染,但移动端首屏实际匹配的是 @media (max-width: 480px),结果提取出一堆无效规则;或者页面依赖 JS 动态插入 DOM,而 critical 默认不等 JS 执行就截屏,导致提取为空。
- 必须显式传参
--mobile或自定义userAgent,确保模拟真实设备 - 若首屏依赖 JS 渲染(如 React/Vue 的
<div id="app"></div>),需加--wait-for="#app .loaded"等 selector 等待条件 - 提取后生成的 CSS 字符串,要通过构建插件(如
html-webpack-plugin的templateParameters)注入到的<style></style>中,不能只保存为文件
Webpack/Vite 构建流程中拦截 HTML 注入内联 CSS
光提取不够,得让构建工具把结果塞进最终 HTML。Vite 用户可用 vite-plugin-critical,Webpack 则常用 html-webpack-plugin 配合 critical 的 API。
容易踩的坑:直接在 index.html 里硬写 <style>{{ CRITICAL_CSS }}</style>,但没配好模板引擎变量替换,结果上线看到的是字面量 {{ CRITICAL_CSS }};或用了 html-webpack-plugin 的 inject: true,却没关掉它默认插入的外部 <link>,导致内联和外链样式同时加载,白忙一场。
立即学习“前端免费学习笔记(深入)”;
阿拉丁·前端工程工坊把「前端只会写页面、规范停在文档里、脚手架手敲、构建靠抄、性能靠猜、可访问性靠忘」从「手动搭项目、抄配置、肉眼查规范」升级成一条本地工具链——多框架脚手架生成(React/Vue3/Svelte + Vite)、可复用组件生成(Props 类型+样式+示例)、规范落地检查(lint-lite:命名/未用变量/console残留/TS any/目录结构)、构建配置生成与产物体积预算、性能审计(依赖体积/重复/懒加载/Lighthouse 清单)、可访问性(a11y)校验(alt/aria
- Vite 插件默认只处理
index.html,多页应用需手动指定include路径 - Webpack 下务必在
html-webpack-plugin的beforeAssetTagGeneration钩子中注入,而非alterAssetTags,否则可能被后续插件覆盖 - 注入前必须做体积检查:
if (criticalCss.length > 1024) { console.warn('Critical CSS too large:', criticalCss.length); return; }
内联后仍白屏?检查是否触发了隐式阻塞
内联 CSS 写进 <style></style> 就万事大吉?不是。以下任一情况都会让浏览器卡住解析,内联失效:
-
document.write()出现在里,直接中断 HTML parser,<style></style>根本不执行 - 存在未加
media="print"的<link rel="stylesheet">,浏览器仍将其视为渲染阻塞资源,和内联 CSS 并行排队 - CSS 里含
url()(比如background: url(./icon.png))或@font-face,这些仍会发起新请求并阻塞整条规则
验证方式唯一:DevTools Network 面板勾选 Offline 后刷新,看首屏文字/按钮是否正常显示。其他都是纸上谈兵。
为什么不能直接用 PostCSS 插件 inline 所有 CSS?
有些工具(如 postcss-inline-svg 或简单正则替换)会把 @import 或 url() 拆出来 inline,但这和“关键 CSS”无关——它只是机械搬运,不识别哪些规则真用于首屏。结果往往是把整个 main.css(50KB)全塞进 HTML,TCP 多一个 RTT,首屏更慢。
真正有效的内联必须满足两个硬条件:内容匹配真实首屏 DOM + 体积 ≤1KB。前者靠模拟渲染路径保证,后者靠人工裁剪或工具限幅。自动化工具有用,但无法绕过对渲染时机和网络约束的理解。

















