前端工程化 / 系统课时
选择 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 插件链
需要成熟插件生态时,安装明确需要的插件,并让 Vite 自动发现项目根目录中的 PostCSS 配置。下面用原生嵌套转换和自动前缀作为示例。
npm add -D postcss postcss-nesting autoprefixer预期输出
added <ID> packages, and audited <ID> packages in <TIME>创建 postcss.config.mjs:
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}
import { defineConfig } from 'vite'
export default defineConfig({
build: {
// 当前默认值即为 lightningcss,这里显式写出以强调职责边界。
cssMinify: 'lightningcss',
},
})执行构建验证整条插件链:
npm run build预期输出
vite v<VERSION> building for production...
✓ <ID> modules transformed.
✓ built in <TIME>方案二:使用 Lightning CSS 全链路
当项目不依赖自定义 PostCSS 插件,并希望由同一引擎完成标准语法降级、前缀和压缩时,可以切换完整 Lightning CSS 转换链。直接在配置中导入目标转换函数时,应把 lightningcss 与 browserslist 声明为项目依赖。:contentReference[oaicite:6]{index=6}
npm add -D lightningcss browserslist预期输出
added <ID> packages, and audited <ID> packages in <TIME>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',
},
})替换配置后再次构建:
npm run build预期输出
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}