使用flutter_screenUtil适配时文本未按设置尺寸缩放问题排查

使用flutter_screenUtil进行屏幕适配时，设置了25.sp的文本字号，但实际显示仍遵循MediaQuery默认尺寸，未按预期缩放。以下是针对性的排查和解决方法：

1. 确认ScreenUtil全局初始化是否正确 #

必须在App入口处完成ScreenUtil的初始化，确保配置全局生效。示例代码：

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return ScreenUtilInit(
      designSize: const Size(375, 812), // 替换为你的设计稿尺寸
      minTextAdapt: true, // 必须开启文本适配开关
      builder: (context, child) {
        return MaterialApp(
          home: child,
          builder: (context, widget) {
            // 固定系统文本缩放因子，避免干扰适配
            return MediaQuery(
              data: MediaQuery.of(context).copyWith(textScaleFactor: 1.0),
              child: widget!,
            );
          },
        );
      },
      child: Page1(),
    );
  }
}

2. 检查TextStyle的定义方式 #

如果TextStyles.subTitle是静态初始化的变量，25.sp会在ScreenUtil初始化前计算，导致使用默认MediaQuery值。解决方法：
将静态变量改为动态getter方法，确保每次获取时使用已初始化的ScreenUtil配置：

// 修改后的TextStyles
class TextStyles {
  static TextStyle get subTitle => TextStyle(
        fontSize: 25.sp,
        fontWeight: FontWeight.bold,
        color: Colors.white,
      );
}

3. 验证文本适配开关是否开启 #

确认ScreenUtilInit的minTextAdapt参数为true，该参数控制文本是否跟随屏幕尺寸自动缩放。若设为false，文本会保持固定像素值，无法实现适配。

4. 排查是否存在MediaQuery覆盖 #

若页面中自定义了MediaQuery（如修改textScaleFactor），可能会干扰ScreenUtil的适配逻辑。确保全局MediaQuery配置与ScreenUtil配合，如上述初始化代码中固定textScaleFactor: 1.0，避免系统字体缩放影响适配效果。

内容的提问来源于stack exchange，提问作者Lokesh Mishra