前端页面适配：postcss-px-to-viewport 插件配置与原理详解

作者：白露

时间：2026-10-31

本文详细介绍 postcss-px-to-viewport 插件的实现原理与配置步骤。该插件通过将 CSS 中的 px 单位自动转换为 vw 或 vh 单位，实现不同屏幕尺寸下的自适应布局。文章涵盖安装依赖、配置文件编写及优缺点分析，帮助开发者提升移动端页面适配效率。

文章目录

一：简介

postcss-px-to-viewport 是一个 PostCSS 插件，旨在将 CSS 中的 px 单位转换为 vw 或 vh 单位。该工具有助于实现不同屏幕尺寸下的自适应布局，从而提升页面的响应性与可用性。

二：postcss-px-to-viewport原理

遍历 CSS 文件中的所有样式规则，定位其中所有的 px 单位值。
依据设备屏幕的宽度和高度，将每个 px 值转换为对应的 vw 或 vh 值。例如，若设备屏幕宽度为 750px，样式表中存在一个宽度为 100px 的元素，插件会将其转换为 13.33vw（计算方式为 100/750*100）。
生成转换后的 CSS 文件。

三：实现步骤

1.安装 postcss-px-viewport 插件及其依赖：

npm install postcss-px-viewport postcss-viewport-units postcss-preset-env -D

其中，postcss-px-viewport 是核心插件，postcss-viewport-units 和 postcss-preset-env 为其依赖项，用于支持更多 CSS 新特性及语法转换。

2.在项目根目录下创建 postcss.config.js 文件，配置 postcss-px-viewport 插件：

module.exports = {
  plugins: {
    'postcss-px-to-viewport': {
      unitToConvert: 'px',  // 需要转换的单位，默认为"px"
      viewportWidth: 320, //  设计稿的视口宽度
      unitPrecision: 5, // 单位转换后保留的精度
      propList: ['*'], // 能转化为vw的属性列表
      viewportUnit: 'vw', //  希望使用的视口单位
      fontViewportUnit: 'vw', // 字体使用的视口单位
      selectorBlackList: [], // 需要忽略的CSS选择器 
      minPixelValue: 1, // 最小的转换数值，如果为1的话，只有大于1的值会被转换
      mediaQuery: false, // 媒体查询里的单位是否需要转换单位
      replace: true, // 是否直接更换属性值，而不添加备用属性
      exclude: [], // 忽略某些文件夹下的文件或特定文件
      include: undefined,  // 如果设置了include，那将只有匹配到的文件才会被转换，例如只转换 'src/mobile' 下的文件 (include: /\/src\/mobile\//)
      landscape: false, // 是否添加根据 landscapeWidth 生成的媒体查询条件 @media (orientation: landscape)
      landscapeUnit: 'vw' // 横屏时使用的单位
    },
     'postcss-preset-env': {
      browsers: 'last 2 versions' //指定只对最近 2 个版本的浏览器进行兼容性处理。
    }
  }
}