Jetpack Compose自定义字体缩放限制函数失效问题排查

问题根源 #

你的代码存在两个核心问题，导致字体缩放限制失效：

1. 双重缩放问题
   你调用20.sp.value获取的是原始sp数值（20），经过limitFontScale计算后返回(20 * 1.5).sp（即30.sp）。但Compose的sp单位会自动应用当前系统的fontScale，当系统fontScale为2.0时，最终渲染大小是30 * 2.0 = 60px；而系统fontScale为1.5时是30 * 1.5 = 45px，这就导致前者显示更大。

2. 函数逻辑方向错误
   你的函数返回的是受系统fontScale影响的sp单位，而正确的逻辑应该是让最终字体大小固定为「原始sp值 × 限制后的fontScale」，避免系统再次缩放。

解决方案 #

方案1：修改扩展函数（局部处理） #

调整函数返回unscaledSp单位（该单位不受系统字体缩放影响），同时直接传入原始sp数值而非sp.value：

@Composable
fun Float.limitFontScale(maxScale: Int = 200): TextUnit {
    val fontScale = LocalDensity.current.fontScale
    val fontScaleLimited = fontScale.coerceAtMost(maxScale.toFloat() / 100f)
    // 使用unscaledSp，避免系统再次应用fontScale
    return (this * fontScaleLimited).unscaledSp
}

使用方式：

Text(
    text = "This is resizing text with font scale ${LocalDensity.current.fontScale}",
    fontSize = 20.limitFontScale(150) // 直接传入原始sp数值20，而非20.sp.value
)

方案2：全局Density注入（推荐） #

通过自定义CompositionLocal注入限制后的Density，让整个范围内的Compose组件自动应用字体缩放限制，无需逐个处理：

@Composable
fun ProvideLimitedFontScale(maxScale: Float = 1.5f, content: @Composable () -> Unit) {
    val originalDensity = LocalDensity.current
    // 限制fontScale不超过最大值
    val limitedFontScale = originalDensity.fontScale.coerceAtMost(maxScale)
    val limitedDensity = originalDensity.copy(fontScale = limitedFontScale)
    // 替换全局Density
    CompositionLocalProvider(LocalDensity provides limitedDensity) {
        content()
    }
}

使用方式：

// 在需要限制字体缩放的父组件中使用
ProvideLimitedFontScale(maxScale = 1.5f) {
    Text(
        text = "This is resizing text with font scale ${LocalDensity.current.fontScale}",
        fontSize = 20.sp
    )
    // 该范围内的所有使用sp单位的组件都会自动应用限制后的fontScale
}

验证 #

执行adb shell settings put system font_scale 2.00和adb shell settings put system font_scale 1.50后，两种方案下Text组件的显示大小将完全一致。

内容的提问来源于stack exchange，提问作者Ralf Wickum