iOS 16中presentationDetents失效求助：从iOS15升级后Sheet异常

架构老林

2026-7-14

解决SwiftUI升级iOS16.4后presentationDetents失效的问题

针对你升级项目后遇到Sheet全屏、presentationDetents被忽略的问题，可按以下步骤排查解决：

确认Deployment Target完全配置正确：
不仅要将Target的iOS版本设置为16.4及以上，还要同步检查Project层级的Deployment Target是否也更新到16.4+。升级项目时容易出现只改Target、漏改Project配置的情况，这会导致SwiftUI新特性无法触发。
移除旧的UIKit兼容代码：
如果项目之前为iOS15及以下版本写过自定义Sheet的UIKit适配逻辑（比如自定义UISheetPresentationController代理、或用UIHostingController包裹时做了特殊处理），这些代码可能会覆盖SwiftUI原生的presentationDetents行为，需要移除或通过版本判断仅在iOS<16时启用。
尝试添加presentationDragIndicator：
虽然不是强制要求，但部分场景下需显式设置拖拽指示器才能让detents生效，修改代码如下：
```
Text("Foo")
  .sheet(isPresented: $isActive) {
    Text("Sheet Content")
      .presentationDetents([.medium])
      .presentationDragIndicator(.visible)
  }
```
清理Xcode缓存：
执行Cmd+Shift+K清理Build Folder，再前往Xcode > Settings > Locations找到Derived Data路径并删除整个文件夹，最后重新编译运行。旧缓存可能导致新配置无法生效。
检查全局修饰符或App层级配置：
查看项目中是否存在全局的ViewModifier，或是在App结构体中设置了影响Sheet表现的全局修饰符，这类配置可能会覆盖局部的presentationDetents设置。
验证Scene配置：
打开Info.plist，检查UIApplicationSceneManifest相关配置，确保场景生命周期设置正确，未禁用iOS16的Sheet相关特性。从旧项目升级的场景中，Scene配置可能存在兼容性问题，可对比新建iOS16.4项目的Info.plist配置进行调整。