构建工具重排CSS顺序会导致@media规则提前失效，因依赖顺序合并、@import打乱、PostCSS插件重排、@layer未识别或动态样式插入破坏层叠逻辑，须检查产物CSS中@media位置并规范配置。
构建工具重排CSS顺序导致@media被提前
Webpack、Vite 等构建工具在打包 CSS 时，常按 JS 模块依赖顺序合并样式，而非你源文件中写的物理顺序。比如你在 base.css 里写了 .btn { color: red; }，又在 responsive.css 里写了 @media (max-width: 768px) { .btn { color: blue; } }，但若 JS 中先 import './base.css' 再 import './responsive.css'，构建后它们会被连成一块；可一旦某处 import 顺序颠倒，或插件（如 postcss-import）把 @import 提前展开，@media 块就可能跑到基础样式前面——结果就是永远不生效。
验证方法：打开最终生成的 HTML，检查 <link> 标签顺序；再打开 Network 面板看实际加载的 CSS 文件内容，搜索 @media 出现的位置，确认它是否在对应选择器声明之后。
- 不要在 CSS 文件里用
@import引入其他样式表——它会打乱原始顺序，且 Webpack/Vite 默认不支持原生@import的顺序保证 - Vite 用户需禁用
css.preprocessorOptions中可能触发自动注入的配置；检查插件如vite-plugin-css-injected-by-js是否把样式插到了末尾 - Webpack 用户应确保所有 CSS
import都集中在一个入口（如index.ts），并严格按「基础 → 组件 → 响应式」顺序书写
PostCSS 插件意外修改规则位置
某些 PostCSS 插件（如 postcss-preset-env、cssnano）在压缩或转换过程中，会重排规则以“优化”体积。例如把所有 h2 相关样式聚到一起，结果就把原本写在 h2 后面的 @media 块拆出来、挪到文件开头——语法没错，但层叠逻辑全毁了。
典型表现：开发环境正常，构建后真机失效；用开发者工具看「Computed」面板，发现目标属性来源是基础样式而非媒体查询，且该媒体查询规则在 Styles 面板里被划掉（strikethrough）。
立即学习“前端免费学习笔记（深入）”；
- 临时关闭
cssnano或设置safe: true参数，避免激进重排 - 在
postcss.config.js中显式指定插件执行顺序，确保postcss-preset-env不在压缩阶段介入 - 对关键响应式文件（如
responsive.css）单独跳过压缩，或用/* prettier-ignore */注释标记区块（部分插件支持）
@layer 声明未被构建工具识别而静默丢弃
如果你用了 @layer 组织媒体查询（例如 @layer responsive { @media (max-width: 768px) { ... } }），但构建流程没启用 postcss-cascade-layers 插件，那么整个 @layer 块会被解析器当作无效 at-rule 直接跳过——不仅媒体查询消失，连带里面的所有样式都丢了，且控制台通常不报错。
这种问题在 Vite + CSS Modules 场景下尤其隐蔽：开发服务器可能因 HMR 机制“凑巧”保留了旧样式，而构建产物彻底清空。
- 检查构建产物 CSS 文件中是否存在
@layer关键字；若完全不见，说明插件未生效或未安装 - Vite 用户必须在
vite.config.ts中显式配置css.postcss.options.plugins并加入postcss-cascade-layers - 注意：使用
@import引入的外部 CSS 不受当前项目的@layer控制，除非它自己也用@layer定义并被同一套插件处理
动态插入样式破坏静态层叠链
有些项目在 JS 中动态创建 <style></style> 标签并注入媒体查询（比如根据用户偏好切换断点），这看似灵活，实则绕过了 CSS 层叠的原始上下文。浏览器把这类动态样式视为“作者样式表”的一部分，但它的插入时机晚于页面初始渲染，且优先级与静态 CSS 不在同一层级——特别是当它和已存在的同名选择器冲突时，行为不可预测。
更麻烦的是，SSR 或服务端渲染场景下，JS 还没执行，动态样式根本不存在，首屏直接回退到非响应式状态。
- 避免在运行时拼接
@media字符串注入；改用预设好的 class 切换（如document.body.classList.toggle('mobile-view')）配合纯 CSS 规则 - 若必须动态，优先用
CSSStyleSheet.insertRule()向已有<style></style>标签追加，而非新建标签 - 所有关键响应式逻辑必须存在于静态 CSS 文件中，JS 只负责开关类名或数据属性
构建后的顺序问题，本质是把“人写的顺序”交给了工具链去解释。最容易被忽略的，不是哪行代码写错了，而是你根本不知道构建产物里那堆 CSS 到底长什么样——务必养成每次构建后手动打开 dist/css/*.css 文件搜索 @media 位置的习惯。
