Swift ViewController中safeAreaLayoutGuide在视图生命周期方法间异常变动问题

核心原因 #

你猜的没错，safeAreaLayoutGuide的布局数值确实会在视图生命周期的不同阶段发生变化：

• viewDidLoad时，视图还未完成屏幕适配计算，safeAreaLayoutGuide的topAnchor值是临时的（默认和view.topAnchor重合）。
• 到viewWillAppear阶段，系统才会根据当前屏幕的状态栏、导航栏高度计算出真实的safeArea值，但你已经在viewDidLoad激活了约束，约束会记录临时的top值。
• 等到viewDidAppear调用self.view.layoutIfNeeded()时，系统会更新safeAreaLayoutGuide的真实约束值，这就导致contentView从临时的top位置动画下移到正确的safeArea位置，看起来像是绑定了view.topAnchor。

另外，你在动画时调用整个self.view的layoutIfNeeded()，会触发所有未完成的布局更新，包括contentView的safeArea约束修正，自然会带动它移动。

解决步骤 #

1. 延迟激活contentView的约束

把contentView约束的激活时机从viewDidLoad移到viewWillAppear（或viewDidLayoutSubviews），确保safeAreaLayoutGuide已经拿到真实的布局数值：

// 先在类里保存约束引用
private var contentViewConstraints: [NSLayoutConstraint] = []

override func viewDidLoad() {
    super.viewDidLoad()
    // 仅创建约束，不激活
    contentView.translatesAutoresizingMaskIntoConstraints = false
    contentViewConstraints = [
        contentView.topAnchor.constraint(equalTo: self.view.safeAreaLayoutGuide.topAnchor),
        contentView.widthAnchor.constraint(equalTo: self.view.widthAnchor, multiplier: 0.9),
        contentView.centerXAnchor.constraint(equalTo: self.view.centerXAnchor)
    ]
}

override func viewWillAppear(_ animated: Bool) {
    super.viewWillAppear(animated)
    // 此时safeArea已计算完成，激活约束
    NSLayoutConstraint.activate(contentViewConstraints)
    
    // 原有进度条初始化逻辑
    progressFillConstraint = progressFill.widthAnchor.constraint(equalTo: progressBackground.widthAnchor, multiplier: progress)
    progressFillConstraint.isActive = true
    newProgressFillConstraint = progressFill.widthAnchor.constraint(equalTo: progressBackground.widthAnchor, multiplier: (currentPage/totalPages))
    newProgressFillConstraint.isActive = false
    self.view.layoutIfNeeded()
}

2. 动画只触发进度条区域的布局更新

不要调用整个self.view的layoutIfNeeded()，只针对进度条所在的父视图调用，避免触发contentView的布局变化：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    defaults.set(currentPage, forKey: "signupProcessProgress")

    progressFillConstraint.isActive = false
    newProgressFillConstraint.isActive = true
    let animationDuration = 2.0
    UIView.animate(withDuration: animationDuration) {
        // 仅更新进度条所在视图的布局，避免全局更新
        self.progressBackground.superview?.layoutIfNeeded()
    }
}

3. 约束冲突检查

调试时打开Xcode的Debug View Hierarchy，检查contentView的约束列表，确认只有你设置的那一条top约束处于激活状态，避免重复添加或意外修改约束的情况。

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