HTML / CSS / 系统课时
优化生产构建体积
优化生产构建体积
生产构建体积过大时,先不要盲目删除样式,而要确认 Tailwind 扫描了哪些源码、动态类名是否被正确表达,以及最终 CSS 是否经过压缩。本课将建立可重复的测量方法,并把优化结果落实到可验证的构建产物。
学习目标
- 建立原始体积与 gzip 体积的构建基线。
- 收紧源码扫描范围,避免无关文件产生候选类名。
- 将动态类名改为可检测的静态映射,并验证压缩结果。
建立构建体积基线
优化前先固定构建命令、代码版本和测量方式,否则两次结果没有可比性。下面的 Node.js 脚本会递归统计 dist 中每个 CSS 文件的原始字节数与 gzip 字节数,可用于 Vite、Webpack 或其他输出到静态目录的项目。
import { readdir, readFile } from "node:fs/promises";
import { gzipSync } from "node:zlib";
import path from "node:path";
async function* walk(directory) {
const entries = await readdir(directory, { withFileTypes: true });
for (const entry of entries) {
const fullPath = path.join(directory, entry.name);
if (entry.isDirectory()) {
yield* walk(fullPath);
} else if (entry.isFile() && entry.name.endsWith(".css")) {
yield fullPath;
}
}
}
const root = process.argv[2] ?? "dist";
let count = 0;
for await (const file of walk(root)) {
const content = await readFile(file);
const gzipBytes = gzipSync(content).length;
console.log(`${file}: ${content.length} bytes, gzip ${gzipBytes} bytes`);
count += 1;
}
if (count === 0) {
console.error(`No CSS files found under ${root}`);
process.exitCode = 1;
}将脚本保存为 scripts/report-css-size.mjs,在项目根目录执行:
npm run build
node scripts/report-css-size.mjs dist预期输出:
dist/assets/index-<HASH>.css: <BYTES> bytes, gzip <GZIP_BYTES> bytes<HASH>、<BYTES> 与 <GZIP_BYTES> 会随项目变化。优化前后都使用同一条命令,并记录 gzip 结果,才能判断体积是否真正下降。
收紧源码扫描范围
Tailwind 根据源码中可识别的完整类名生成 CSS。扫描目录过宽会把演示文件、旧页面、测试夹具或备份代码中的类名一并纳入候选集合;扫描目录过窄则会导致真实样式缺失。路径应围绕实际入口和共享组件设置,并注意 @source 路径相对于当前样式表解析。

需要完全控制扫描来源时,可在入口 CSS 中关闭自动检测,再显式登记目录:
@import "tailwindcss" source(none);
@source "./";
@source "../shared-ui";这段配置表示扫描当前样式表所在目录及根目录下的 shared-ui。验证时重新构建,并确认真实页面仍完整、体积报告没有异常增长;不要为了省体积排除运行时确实会渲染的模板目录。
把动态类名改为静态映射
bg-${tone}-600 这类字符串拼接不会在源码中形成完整候选类名,既可能让样式缺失,也容易迫使团队加入过大的兜底列表。更稳定的做法是把允许值映射到完整类名。下面是片段示例,依赖 React 与 TypeScript 项目。
const toneClasses = {
primary: "bg-sky-600 hover:bg-sky-700",
danger: "bg-red-600 hover:bg-red-700",
} as const;
type Tone = keyof typeof toneClasses;
export function ActionButton(props: { tone: Tone; label: string }) {
const { tone, label } = props;
return (
<button
className={`${toneClasses[tone]} rounded-md px-4 py-2 text-white`}
>
{label}
</button>
);
}构建器现在可以直接检测所有完整类名,组件也只接受声明过的变体。页面可见结果是 primary 与 danger 分别得到蓝色和红色按钮,并保留各自的悬停状态。
执行生产压缩并验收
若项目直接使用 Tailwind CLI,可在已安装 tailwindcss 与 @tailwindcss/cli 的项目中执行压缩构建,再复用体积脚本检查结果:
npx @tailwindcss/cli -i ./src/app.css -o ./dist/app.css --minify
node scripts/report-css-size.mjs dist预期输出:
≈ tailwindcss v<VERSION>
Done in <TIME>
dist/app.css: <BYTES> bytes, gzip <GZIP_BYTES> bytes验收不能只看数字。还要抽查响应式、暗色模式、hover、focus-visible、group 和 peer 等状态,确认优化没有排除真实来源。若体积反而增加,应优先检查新增扫描目录、整段静态类名列表和外部组件库,而不是继续压缩图片或 JavaScript。