HTML / CSS / 系统课时

优化生产构建体积

优化生产构建体积

生产构建体积过大时,先不要盲目删除样式,而要确认 Tailwind 扫描了哪些源码、动态类名是否被正确表达,以及最终 CSS 是否经过压缩。本课将建立可重复的测量方法,并把优化结果落实到可验证的构建产物。

学习目标

  • 建立原始体积与 gzip 体积的构建基线。
  • 收紧源码扫描范围,避免无关文件产生候选类名。
  • 将动态类名改为可检测的静态映射,并验证压缩结果。

建立构建体积基线

优化前先固定构建命令、代码版本和测量方式,否则两次结果没有可比性。下面的 Node.js 脚本会递归统计 dist 中每个 CSS 文件的原始字节数与 gzip 字节数,可用于 Vite、Webpack 或其他输出到静态目录的项目。

js
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,在项目根目录执行:

bash
npm run build
node scripts/report-css-size.mjs dist

预期输出:

text
dist/assets/index-<HASH>.css: <BYTES> bytes, gzip <GZIP_BYTES> bytes

<HASH>、<BYTES> 与 <GZIP_BYTES> 会随项目变化。优化前后都使用同一条命令,并记录 gzip 结果,才能判断体积是否真正下降。

收紧源码扫描范围

Tailwind 根据源码中可识别的完整类名生成 CSS。扫描目录过宽会把演示文件、旧页面、测试夹具或备份代码中的类名一并纳入候选集合;扫描目录过窄则会导致真实样式缺失。路径应围绕实际入口和共享组件设置,并注意 @source 路径相对于当前样式表解析。

Tailwind 生产构建体积优化链路

需要完全控制扫描来源时,可在入口 CSS 中关闭自动检测,再显式登记目录:

css
@import "tailwindcss" source(none);
@source "./";
@source "../shared-ui";

这段配置表示扫描当前样式表所在目录及根目录下的 shared-ui。验证时重新构建,并确认真实页面仍完整、体积报告没有异常增长;不要为了省体积排除运行时确实会渲染的模板目录。

把动态类名改为静态映射

bg-${tone}-600 这类字符串拼接不会在源码中形成完整候选类名,既可能让样式缺失,也容易迫使团队加入过大的兜底列表。更稳定的做法是把允许值映射到完整类名。下面是片段示例,依赖 React 与 TypeScript 项目。

tsx
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 的项目中执行压缩构建,再复用体积脚本检查结果:

bash
npx @tailwindcss/cli -i ./src/app.css -o ./dist/app.css --minify
node scripts/report-css-size.mjs dist

预期输出:

text
≈ tailwindcss v<VERSION>
Done in <TIME>
dist/app.css: <BYTES> bytes, gzip <GZIP_BYTES> bytes

验收不能只看数字。还要抽查响应式、暗色模式、hover、focus-visible、group 和 peer 等状态,确认优化没有排除真实来源。若体积反而增加,应优先检查新增扫描目录、整段静态类名列表和外部组件库,而不是继续压缩图片或 JavaScript。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

优化生产构建体积

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通