postcss-px-to-viewport-CSDN博客

这是一个 PostCSS 插件，用于将 CSS 中的 px 单位自动转换为视口单位（如 vw/vh/vmin/vmax），适配不同尺寸的移动端设备，实现响应式布局。

npm install postcss-px-to-viewport --save-dev

/*
 * @Author:
 * @Date: 2025-11-24 15:22:32
 * @LastEditors: Please set LastEditors
 * @LastEditTime: 2025-11-24 15:22:32
 * @Description: postcss 配置 样式适配
 */

module.exports = {
  plugins: {
    autoprefixer: {},
    "postcss-px-to-viewport": {
      // 视窗的宽度，对应的是我们设计稿的宽度，一般是750
      viewportWidth: 375,
      // 视窗的高度，根据750设备的宽度来指定，一般指定1334，也可以不配置
      // viewportHeight: 1334,
      // 指定`px`转换为视窗单位值的小数位数
      unitPrecision: 3,
      // 指定需要转换成的视窗单位，建议使用vw
      viewportUnit: "vw",
      // 指定不转换为视窗单位的类，可以自定义，可以无限添加,建议定义一至两个通用的类名
      selectorBlackList: [".ignore"],
      // 小于或等于`1px`不转换为视窗单位，你也可以设置为你想要的值
      minPixelValue: 1,
      // 允许在媒体查询中转换`px`
      mediaQuery: false,
    },
  },
};

postcss-px-to-viewport