uni.getSystemInfoSync().statusBarHeight 返回 px 值,需用公式 rpx = px × 750 / screenWidth 动态转为 rpx,screenWidth 必须实时获取,不可缓存或硬编码;H5 端需配置 rpxCalculation: "auto" 并监听 resize。

uni.getSystemInfoSync().statusBarHeight 返回的是 px,不是 rpx
状态栏高度在 uni-app 中通过 uni.getSystemInfoSync().statusBarHeight 获取,返回值单位是 **物理像素(px)**,且该值不随横竖屏切换变化(iOS/Android 均为固定上报值)。它和 rpx 无直接映射关系,不能直接当 rpx 用——比如你在样式里写 padding-top: {{statusBarHeight}}rpx,结果会严重偏高。
px → rpx 转换必须动态计算,不能复用旧值
要把 statusBarHeight 的 px 值转成 rpx(例如用于 padding-top 或 top 定位),唯一可靠公式是:rpx = px × 750 / screenWidth,其中 screenWidth 必须每次调用时实时获取:
- ✅ 正确做法:封装函数,在需要时同步调用
uni.getSystemInfoSync() - ❌ 错误做法:在
onLaunch缓存screenWidth后反复使用——横屏后错乱 - ❌ 错误做法:用异步
uni.getSystemInfo(),却在回调外就执行转换——拿到undefined - ❌ 错误做法:硬编码比例(如 × 2 或 ÷ 0.5)——H5 下 1rpx = 1px,安卓真机可能是 0.8,误差放大明显
示例:
const pxToRpx = (px) => {<br> const { screenWidth } = uni.getSystemInfoSync();<br> return (px * 750) / screenWidth;<br>};<br>const statusBarRpx = pxToRpx(uni.getSystemInfoSync().statusBarHeight);
rpx → px 用 uni.upx2px(),但状态栏场景极少需要反向转换
如果你已有一个 rpx 值(比如设计稿标注“状态栏下留空 40rpx”),想转成 px 参与 JS 计算(如动态设置 transform 或 canvas 偏移),直接用 uni.upx2px(40) 即可。它内部等价于 Math.round(screenWidth / 750 * 40),且每次调用都同步读取最新 screenWidth。
- ⚠️ 注意:
uni.upx2px()返回整数(四舍五入),如需小数精度,自行封装:Math.round(uni.upx2px(40) * 100) / 100 - ⚠️ 注意:不要用
uni.upx2px(100)/100算缩放比再倒推 px→rpx——这在 H5 和 Android 上结果不一致,不可靠
H5 端特别容易出错:默认按 375 屏宽计算,不响应窗口缩放
H5 端的 uni.upx2px() 默认强制按 screenWidth = 375 计算(即 1rpx = 0.5px),哪怕你拖大浏览器到 1920px 宽也如此。这意味着:
- 状态栏高度在 H5 上用
pxToRpx(statusBarHeight)会得到偏大的 rpx 值(因为分母是真实screenWidth,而样式层 rpx 解析却是按 375 算的) - 若需 H5 真正响应窗口变化,必须在
manifest.json中配置:"h5": { "rpxCalculation": "auto" },并监听window.onresize重新计算 - 更稳妥的做法:状态栏相关布局尽量用 px +
position: fixed或 CSS 变量控制,避开 rpx 动态计算
真正难处理的从来不是公式本身,而是「谁在什么时候、用哪个 screenWidth 值」——同一台设备,JS 里 getSystemInfoSync() 拿到的 screenWidth、CSS 渲染时 rpx 解析用的基准、canvas 绘图需要的像素坐标,三者可能来自不同逻辑分支,稍不注意就错位。


















