uni.getsysteminfosync() 返回的 screenwidth/screenheight 是物理像素,如 iphone 14 pro 对应 1170×2532;windowwidth/windowheight 才是动态逻辑尺寸;pixelratio 表示物理像素与 css 像素比,影响高清图加载与 canvas 渲染。

uni.getSystemInfoSync() 返回的 screenWidth/screenHeight 是物理像素还是逻辑像素?
返回的是设备屏幕的**物理像素值**,不是 CSS 像素或逻辑像素。比如 iPhone 14 Pro 的 screenWidth 是 1170,screenHeight 是 2532 —— 这就是它真实 LCD 面板的像素数。
但要注意:windowWidth 和 windowHeight 才是当前渲染区域的逻辑尺寸(单位:px),受状态栏、导航栏、软键盘弹出等影响,实际可用视口可能更小。
-
screenWidth/screenHeight:固定不变,代表整块屏幕物理分辨率 -
windowWidth/windowHeight:动态变化,代表当前 WebView 可绘制区域大小 - 两者在全屏无导航栏时可能接近,但绝不等价
pixelRatio 是什么?它和 DPI/PPI 有什么关系?
pixelRatio 是设备像素比(device pixel ratio),等于 物理像素 / CSS 像素。它不直接等于系统标称的 DPI 或 PPI,但高度相关 —— 比如 pixelRatio === 3 意味着 1 个 CSS 像素要由 3×3=9 个物理像素渲染。
这个值决定了高清图加载策略、canvas 绘制缩放、字体渲染精度等关键行为。
- iOS 设备通常为 2 或 3(iPhone 8 是 2,iPhone 14 Pro 是 3)
- Android 设备差异大,常见 2.0、2.75、3.0、3.5+,部分厂商还伪造该值
- 不能用
pixelRatio精确换算 DPI,但可用于分级选图(如@2x/@3x)
App 端获取失败或数值异常的常见原因
在 App(iOS/Android)环境下,uni.getSystemInfoSync() 有时返回默认值(如 screenWidth: 375)或明显错误值,主要因为:
- 调用时机太早:在
onLoad之前(如data初始化阶段)调用,此时 native 层尚未就绪 - Android 权限缺失:某些定制 ROM(如华为 EMUI、小米 MIUI)需声明
android.permission.READ_PHONE_STATE才能准确读取屏幕参数(虽非强制,但影响部分字段) - 微信小程序混淆:如果项目同时编译到微信小程序,
getSystemInfoSync在小程序端返回的是逻辑尺寸,容易误判为 App 行为 - 未区分平台:iOS 的
screenHeight包含底部安全区,而 Android 多数不包含;建议优先用windowHeight做布局,用screenHeight做资源适配
推荐写法:安全获取并缓存屏幕信息
不要每次渲染都调用 uni.getSystemInfoSync(),也不要在 data 里直接赋值。应封装成可复用的工具函数,并在生命周期早期(onLaunch 或首个页面 onLoad)执行一次缓存。
const screenInfo = (() => {
try {
const info = uni.getSystemInfoSync()
return {
width: info.screenWidth,
height: info.screenHeight,
dpr: info.pixelRatio,
windowWidth: info.windowWidth,
windowHeight: info.windowHeight
}
} catch (e) {
// fallback to safe defaults
return { width: 750, height: 1334, dpr: 1, windowWidth: 750, windowHeight: 1200 }
}
})()
后续组件中直接引用 screenInfo.width 即可,避免重复调用和异常中断渲染。
真正容易被忽略的是:App 启动后屏幕方向切换(横竖屏)不会触发 getSystemInfoSync 自动更新 —— 如果你的应用支持横屏,必须监听 uni.onWindowResize 并手动刷新 windowWidth/windowHeight,screenWidth/screenHeight 则始终不变。











