Flutter应用在iOS iPhone真机/模拟器上无法占满屏幕全高如何解决

该问题是iOS端App运行在兼容模式下的典型表现，仅会在iOS设备触发，Android不受影响，核心诱因通常为以下两类：

• 启动屏配置错误：iOS项目未使用系统标准的UILaunchScreen配置，而是沿用了旧版固定尺寸的静态启动图资源，系统无法识别当前设备的原生渲染分辨率，自动给App加上下黑边以兼容旧设备分辨率，导致App无法占满全屏幕高度。只要出现所有iPhone机型都无法铺满高度、Android表现完全正常的情况，优先排查启动屏配置，90%以上的场景都是这个问题导致的。
• 全局布局配置错误：在应用根节点（如MaterialApp外层）错误全局包裹了SafeArea组件，强制给整个应用加上四周安全边距，或是根Scaffold未开启边缘延伸配置，导致内容无法铺满全屏。

步骤1：修正iOS端启动屏配置 #

1. 打开项目路径下的ios/Runner/Info.plist文件，删除所有和UILaunchImages相关的静态启动图配置项，添加标准的UILaunchScreen配置：

<key>UILaunchScreen</key>
<dict>
    <key>UILaunchScreenBackgroundColor</key>
    <string>#FFFFFF</string> <!-- 替换为你自己的启动页背景色值 -->
    <!-- 如需在启动页展示logo，可保留下方两行，提前将logo资源存入ios/Runner/Assets.xcassets即可 -->
    <key>UIImageName</key>
    <string>LaunchLogo</string>
</dict>

2. 用Xcode打开iOS项目，进入Runner -> General -> App Icons and Launch Screen设置项，确认Launch Screen File选中LaunchScreen.storyboard，同时勾选Requires full screen选项。
3. 执行以下命令清理缓存后重新编译：

flutter clean
rm -rf ios/build
flutter pub get

步骤2：检查全局布局配置 #

如果启动屏配置修正后问题仍存在，检查布局代码：

• 禁止在MaterialApp、CupertinoApp这类应用根节点外层直接包裹SafeArea，否则会全局强制加边距导致无法铺满屏幕。
• 如需让页面内容延伸到顶部刘海区、底部横条区域，给根布局的Scaffold添加如下配置：

Scaffold(
  extendBody: true, // 允许内容延伸到底部安全区域
  extendBodyBehindAppBar: true, // 允许内容延伸到顶部状态栏、AppBar区域
  // 其余页面逻辑
)

• 针对需要避开刘海、底部操作横条的页面内容，在对应页面的局部组件上按需包裹SafeArea即可，不要全局配置。

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