在vite构建时将关键css内联到html头部,最直接且稳定的做法是使用官方插件 @vitejs/plugin-basic-ssl 配合自定义逻辑,或者更推荐直接使用社区成熟的 vite-plugin-html 结合 critical 库。核心思路是在构建过程中拦截生成的html文件,提取入口js对应的关键css(critical css),将其包裹在 标签中插入到 顶部,而将剩余的非关键css保留在外部链接中。这样做可以显著减少首屏渲染的阻塞时间,提升lcp指标。

如何配置 vite-plugin-html 实现自动内联?
使用 vite-plugin-html 插件可以简化这一过程,它允许在Vite配置中直接定义HTML模板的处理逻辑。通过引入 critical 包,可以在构建时分析页面内容并生成关键CSS。具体做法是在 vite.config.js 中配置该插件,并在其 transformHtml 钩子中调用 critical.generate() 方法。该方法需要传入目标HTML字符串、根路径以及要提取的关键CSS选择器或尺寸信息。执行后,插件会将返回的内联CSS代码注入到HTML的 中,从而完成内联操作。

import { defineConfig } from 'vite';
import basicSsl from '@vitejs/plugin-basic-ssl';
import { createHtmlPlugin } from 'vite-plugin-html';
import critical from 'critical';
export default defineConfig({
plugins: [
basicSsl(),
createHtmlPlugin({
minify: true,
inject: {
data: {
title: 'My App',
},
},
// 这里通常结合自定义插件或使用 vite-plugin-critical
// 下面展示一个简化的手动注入逻辑示例
}),
],
});
// 实际使用中,建议安装 vite-plugin-critical
// npm i vite-plugin-critical -D
// 然后在 config 中引入并使用
如何手动编写 Vite 插件来注入 Critical CSS?
如果不希望依赖额外的第三方HTML插件,可以手动编写一个Vite插件来实现相同的功能。这个插件需要在 buildEnd 阶段介入,读取生成的HTML文件,然后利用 critical 库提取关键样式。首先,你需要确保在开发环境中也能正确加载资源,因此插件需要知道项目的根目录和输出目录。接着,在构建结束后,遍历 dist 目录下的HTML文件,对每个文件应用 critical.generate()。最后,将生成的内联CSS替换回HTML的 部分并写回磁盘。这种方法提供了更高的灵活性,允许你根据特定页面的需求定制关键CSS的提取策略。

// vite.config.js
import { defineConfig } from 'vite';
import path from 'path';
export default defineConfig({
plugins: [
{
name: 'inline-critical-css',
async buildEnd() {
const fs = require('fs');
const path = require('path');
const critical = require('critical');
const distPath = path.resolve(__dirname, 'dist');
const htmlFiles = fs.readdirSync(distPath).filter(f => f.endsWith('.html'));
for (const file of htmlFiles) {
const filePath = path.join(distPath, file);
const htmlContent = fs.readFileSync(filePath, 'utf8');
try {
const result = await critical.generate({
base: distPath,
html: htmlContent,
width: 1440,
height: 900,
inline: true,
minify: true,
});
fs.writeFileSync(filePath, result.html, 'utf8');
} catch (e) {
console.error(`Failed to process ${file}:`, e);
}
}
},
},
],
});
当页面包含动态加载的组件时,关键CSS提取会遇到什么问题?
当页面包含动态加载的组件或路由时,静态的关键CSS提取工具可能无法准确识别所有首屏所需的样式。这是因为 critical 等工具主要基于静态HTML结构和已知的CSS选择器进行分析,对于通过JavaScript异步加载的内容,它们往往无能为力。这会导致提取出的关键CSS不完整,进而引起首屏样式闪烁(FOUC)或布局偏移。解决这个问题的最佳实践是手动指定关键CSS的选择器,或者在构建前预渲染SSR页面,确保HTML中包含所有必要的DOM结构。此外,也可以考虑使用服务端渲染(SSR)框架如Nuxt或Remix,它们能更好地处理首屏样式的优化。
前端入门到VUE实战笔记:立即使用
在学习笔记中,你将探索 前端 的入门与实战技巧!











