前端工程化 / 系统课时

选择 PostCSS 与 Lightning CSS

选择 PostCSS 与 Lightning CSS

本课把 Vite 的 CSS 转换与压缩拆成可观察的处理链,分别配置 PostCSS 插件方案和 Lightning CSS 全链路方案,并建立一套从引擎选择、配置发现到浏览器目标的冲突排查顺序。

学习目标

  • 区分 CSS 转换器与生产压缩器的职责
  • 根据插件需求选择 PostCSS 或 Lightning CSS 全链路
  • 定位重复转换、配置未加载和兼容目标不一致问题

先拆分两层职责

在当前 Vite 中,css.transformer 默认仍为 postcss,而生产构建的 CSS 压缩默认使用 Lightning CSS。也就是说,“使用 Lightning CSS 压缩”不等于“所有 CSS 都交给 Lightning CSS 转换”;只有显式设置 css.transformer: 'lightningcss' 才会切换完整处理引擎,而且该能力目前仍标记为实验性。:contentReference[oaicite:4]{index=4}

选择 更适合的场景 关键配置
PostCSS 转换 + Lightning CSS 压缩 依赖 Tailwind、定制 PostCSS 插件或成熟插件生态 保持 css.transformer 默认值,配置 postcss.config.mjs
Lightning CSS 全链路 主要需要标准 CSS 降级、前缀、压缩和内置 CSS Modules 设置 css.transformer: 'lightningcss' 与 css.lightningcss

PostCSS 与 Lightning CSS 在 Vite 中的职责对比

方案一:保留 PostCSS 插件链

需要成熟插件生态时,安装明确需要的插件,并让 Vite 自动发现项目根目录中的 PostCSS 配置。下面用原生嵌套转换和自动前缀作为示例。

bash
npm add -D postcss postcss-nesting autoprefixer

预期输出

text
added <ID> packages, and audited <ID> packages in <TIME>

创建 postcss.config.mjs:

js
import autoprefixer from 'autoprefixer'
import postcssNesting from 'postcss-nesting'

export default {
  plugins: [
    // 先展开嵌套,再根据目标浏览器补充必要前缀。
    postcssNesting(),
    autoprefixer(),
  ],
}

Vite 会把有效的 PostCSS 配置应用到导入的 CSS,之后再执行生产压缩。若在 vite.config.ts 中提供内联 css.postcss,Vite 将不再搜索其他 PostCSS 配置来源。:contentReference[oaicite:5]{index=5}

ts
import { defineConfig } from 'vite'

export default defineConfig({
  build: {
    // 当前默认值即为 lightningcss,这里显式写出以强调职责边界。
    cssMinify: 'lightningcss',
  },
})

执行构建验证整条插件链:

bash
npm run build

预期输出

text
vite v<VERSION> building for production...
✓ <ID> modules transformed.
✓ built in <TIME>

方案二:使用 Lightning CSS 全链路

当项目不依赖自定义 PostCSS 插件,并希望由同一引擎完成标准语法降级、前缀和压缩时,可以切换完整 Lightning CSS 转换链。直接在配置中导入目标转换函数时,应把 lightningcss 与 browserslist 声明为项目依赖。:contentReference[oaicite:6]{index=6}

bash
npm add -D lightningcss browserslist

预期输出

text
added <ID> packages, and audited <ID> packages in <TIME>
ts
import browserslist from 'browserslist'
import { browserslistToTargets } from 'lightningcss'
import { defineConfig } from 'vite'

const targets = browserslistToTargets(browserslist('defaults'))

export default defineConfig({
  css: {
    transformer: 'lightningcss',
    lightningcss: {
      targets,
      drafts: {
        nesting: true,
      },
    },
  },
  build: {
    cssMinify: 'lightningcss',
  },
})

替换配置后再次构建:

bash
npm run build

预期输出

text
vite v<VERSION> building for production...
✓ <ID> modules transformed.
✓ built in <TIME>

若项目使用 CSS Modules,完整 Lightning CSS 模式下不要继续修改 css.modules,应改用 css.lightningcss.cssModules。:contentReference[oaicite:7]{index=7}

按顺序定位处理冲突

先确认 css.transformer 的实际值。保持默认值时排查 PostCSS 配置和插件顺序;设为 lightningcss 时,不要假设 postcss.config.mjs 中的自定义插件仍参与同一转换链。

再检查配置来源。若同时存在根目录 PostCSS 文件和内联 css.postcss,只有内联配置生效;删除其中一处,避免“修改了文件却没有反应”。

随后检查重复职责。嵌套、前缀、颜色降级或压缩只保留一个主要负责者,每次暂时移除一个插件并重新构建,对比产物是否恢复稳定。

最后统一兼容目标。PostCSS 插件常读取 Browserslist,Lightning CSS 全链路读取 css.lightningcss.targets,默认压缩还会受 Vite 的 CSS 构建目标影响;不要让多处目标范围互相矛盾,应以实际支持矩阵建立单一来源并用目标浏览器验收。:contentReference[oaicite:8]{index=8}

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

目录与阅读设置

阅读设置

17

记录一个想法

选择 PostCSS 与 Lightning CSS

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

登录哪都通