UIStackView子视图移除/高度变化时无法自动重算布局高度

核心问题原因 #

你遇到的布局异常来自3个UIStackView的典型使用误区：

• removeArrangedSubview(_:) 仅会将视图从StackView的排列管理列表中移除，不会将视图从父视图层级中删除，被移出排列列表的视图依然会停留在原位置、保留原尺寸，这就是移除subView2后下方留空白的直接原因。
• 未给子视图设置正确的内容拉伸/压缩优先级，StackView无法判断哪个子视图应该自动填充剩余空间，会默认保留子视图初始的尺寸约束。
• 动态修改子视图内部内容、尺寸后未主动触发布局刷新，StackView不会自动感知子视图内部的约束变化重新计算位置；反复移除再重新添加arrangedSubview反而会破坏StackView内部的约束管理逻辑，直接导致子视图重叠。

分步修复方案 #

1. 正确执行子视图移除操作 #

如果需要彻底移除某个子视图、让剩余视图填充空间，不能只调用removeArrangedSubview，必须同步将视图从父视图层级删除：

// 从StackView的排列管理列表中移除
container?.removeArrangedSubview(subView2)
// 从视图层级中彻底删除，这一步是多数开发者遗漏的核心操作
subView2.removeFromSuperview()
// 主动触发布局更新
container?.layoutIfNeeded()

如果只是临时隐藏子视图、后续还要显示，不需要调用移除方法，直接设置子视图isHidden = true即可，StackView会自动将隐藏子视图所占空间分配给其他可见子视图，效率远高于移除再添加。

2. 配置子视图布局优先级 #

需要明确告知StackView哪个子视图负责拉伸填充剩余空间，通过内容拥抱、压缩阻力优先级区分两个子视图的布局规则：

// 在initLayout方法中，添加完arrangedSubview后追加以下代码
// subView1为需要填充剩余空间的视图，设置低优先级，允许被拉伸
subView1.setContentHuggingPriority(.defaultLow, for: .vertical)
subView1.setContentCompressionResistancePriority(.defaultLow, for: .vertical)
// subView2为靠自身内容撑高度的视图，设置高优先级，保证尺寸匹配内容
subView2.setContentHuggingPriority(.required, for: .vertical)
subView2.setContentCompressionResistancePriority(.required, for: .vertical)

配置完成后，StackView会优先保证subView2的高度完全匹配内部内容，剩余所有垂直空间会自动分配给subView1，不会出现高度不更新的问题。

3. 动态修改内容后正确刷新布局 #

当你需要向subView2中添加选项、修改内部内容改变高度时，不需要反复移除再重新添加子视图，只需要在内容修改完成后主动触发布局刷新即可：

// 完成subView2内部子视图添加、约束更新后调用
container?.setNeedsLayout()
container?.layoutIfNeeded()

避坑提示 #

• 不要手动给StackView的arrangedSubview添加高度、垂直方向位置约束，这类手动约束的优先级会高于StackView的自动布局逻辑，直接导致StackView无法重新计算子视图尺寸，出现位置固定、重叠的问题。
• 如果subView1、subView2本身也是垂直方向的UIStackView，将需要填充空间的子StackView的distribution属性设置为.fill即可，不需要额外给子StackView设置固定高度约束。
• 如果需要子视图显示/隐藏的过渡动画，将isHidden属性修改和layoutIfNeeded()调用放在同一个UIView.animate动画块中即可实现平滑效果。

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