漏转常见于exclude配置误伤或路径匹配失败、propList设置过窄、mediaQuery关闭导致@media内px不转换、预处理器与PostCSS协同问题等。
漏转常见于 exclude 配置误伤或文件路径匹配失败
插件默认处理所有 .css、.vue（含 <style></style>）和 .scss 等样式文件，但一旦配置了 exclude，它会逐个比对文件路径字符串——不是按目录结构，而是按完整相对路径（如 src/views/Home.vue）。很多漏转问题就出在这里：
-
exclude: [/node_modules/]看似合理，但如果项目用了别名（如@/styles/），而实际路径是src/styles/common.css，这个正则根本不会命中 -
exclude: ['src/components']是字符串全等匹配，但真实路径可能是src/components/Button.vue——不匹配，本该排除的没排除；而src/pages/Home.vue却可能因路径拼写差异（大小写、斜杠方向）被意外排除 - 在 Vue CLI 或 Vite 中，
<style scoped></style>生成的 CSS 是通过 PostCSS pipeline 注入的，但某些 loader（如vue-style-loader）可能绕过 PostCSS 配置，导致 scoped 样式未参与转换
propList 设置过窄会导致属性级漏转
propList 控制哪些 CSS 属性里的 px 值会被转换。默认 ['*'] 表示全部，但如果你改成 ['width', 'height']，那 line-height: 24px、top: 10px、box-shadow: 0 2px 4px rgba(0,0,0,.1) 全部逃过转换——尤其 box-shadow 和 transform 里的像素值，容易被忽略。
- 必须确认你是否显式缩小了
propList，比如为了保留border而只留布局类属性，结果把font-size也漏掉了 -
font-size在移动端极其关键，如果没列在propList里，且没单独配fontViewportUnit，就会原样保留px - 第三方 UI 库组件内部样式（如
el-button的padding）是否被selectorBlackList拦截，也要检查类名是否真能匹配到渲染后的实际 class
mediaQuery: false 会让 @media 内部的 px 完全不转
很多人关掉 mediaQuery 是怕断点错乱，结果发现 @media (max-width: 750px) { .box { width: 300px; } } 里的 300px 一动不动——插件压根不进这个块。这不是 bug，是设计行为：当 mediaQuery: false 时，插件跳过整个媒体查询节点。
- 移动端响应式断点本身就需要随视口缩放，比如
max-width: 750px在 iPhone SE 上是临界点，但在 iPad 上应是max-width: 100vw才合理 - 若你确实需要保留固定像素断点（如仅针对 PC 媒体查询），建议用
exclude过滤掉 PC 相关样式文件，而不是全局关mediaQuery - 开启
mediaQuery: true后，注意viewportWidth仍只作用于主文档流，媒体查询中的px值仍按同一基准换算，不会自动适配不同设备断点
Vue SFC 中
PostCSS 处理的是最终生成的 CSS 字符串，不是 SCSS 源码。如果使用 lang="scss"，Sass loader 必须在 PostCSS loader 之前执行，否则插件拿到的是未编译的嵌套语法（如 .parent { .child { width: 100px; } }），而部分版本的 postcss-px-to-viewport 对嵌套声明的支持不完整。
立即学习“前端免费学习笔记（深入）”；
- 检查 Webpack/Vite 构建链顺序：
sass-loader → postcss-loader → css-loader缺一不可 - 在 Vue 3 + Vite 项目中，
<style scoped></style>经过vue/compiler-sfc处理后会加属性选择器（如[v-data-id]），若 PostCSS 插件版本太老（如postcss-px-to-viewport@1.1.0），可能无法正确遍历带属性选择器的嵌套规则 - 临时验证方式：把
<style lang="scss"></style>改成<style></style>，写平铺 CSS，看是否还漏转——如果好了，就是预处理器与 PostCSS 协同问题
postcss-px-to-viewport 的报错或警告，再打开生成的 CSS 文件，搜索几个明确写了 px 的地方，反向追踪它们在源码中的位置和上下文。 
