UITableView适配横竖屏方向切换无反应该如何解决

云原生阿岚

2026-10-6

UITableView 不响应横屏切换解决方案

核心问题原因

你当前的写法不生效主要有两个常见原因：

项目全局或当前视图控制器（含父容器控制器）未开启对应横竖屏支持权限
willTransition 触发时视图转场尚未完成，此时UITableView的尺寸仍为转场前的数值，直接调用reloadData会沿用旧尺寸计算布局

分步解决方法

1. 开启屏幕旋转权限

首先检查全局配置：打开Xcode项目的 Targets -> General -> Deployment Info 面板，在Device Orientation栏勾选所有你需要支持的方向（至少包含竖屏和需要使用的横屏方向）。
其次确认视图控制器的旋转权限：

如果当前页面是独立的UIViewController，重写如下属性：

override var shouldAutorotate: Bool {
    return true
}
// 如需单独指定当前页面支持的方向，可重写以下属性
override var supportedInterfaceOrientations: UIInterfaceOrientationMask {
    return .all // 可替换为你需要的方向组合，比如.allButUpsideDown
}

如果当前页面嵌套在UINavigationController、UITabBarController等容器控制器中，需要给对应的容器控制器也重写上述两个属性，否则子页面的配置不会生效。

2. 修正转场刷新时机

将UITableView的刷新逻辑放到转场动画完成的回调中，确保刷新时视图已经完成尺寸更新：

override func willTransition(to newCollection: UITraitCollection, with coordinator: UIViewControllerTransitionCoordinator) {
    super.willTransition(to: newCollection, with: coordinator)
    coordinator.animate(alongsideTransition: nil) { _ in
        self.tableView.reloadData()
        // 若仅需调整布局无需刷新数据，可替换为 self.tableView.layoutIfNeeded()，性能更优
    }
}