UIButton标题短时间显示Storyboard默认值而非代码设置值如何解决

问题根因 #

该现象是UICollectionViewCell加载时序和UIButton属性渲染逻辑共同导致的：

• Storyboard中设置的控件默认属性会在cell通过init(coder:)初始化时直接生效，而你在cellForItemAt中调用setTitleButton的操作晚于初始化阶段，两者的执行间隔会导致默认值先被渲染到屏幕上。
• 若使用iOS15+引入的UIButtonConfiguration，直接调用setTitle方法不会主动覆盖configuration中的默认标题值，易出现标题反复闪回的异常。
• cell复用时如果没有提前清理旧标题，也会叠加状态冲突。

可行解决方案（无需清空Storyboard按钮标题） #

以下方案均不影响Storyboard画布的编辑预览，仅在运行时生效：

• 在自定义cell的awakeFromNib中提前重置默认值
  awakeFromNib是Storyboard控件加载完成后第一个触发的生命周期方法，在该方法中重置按钮标题即可提前清除Storyboard的默认值，早于cell出列渲染：

override func awakeFromNib() {
    super.awakeFromNib()
    // 重置两个按钮的标题，不影响Storyboard编辑态的显示
    button1.setTitle(nil, for: .normal)
    button2.setTitle(nil, for: .normal)
    // 若使用UIButtonConfiguration，加以下代码
    button1.configuration?.title = nil
    button2.configuration?.title = nil
}

• 优化setTitleButton方法的实现
  明确指定所有状态的标题，设置完成后强制立即刷新布局，避免渲染延迟：

func setTitleButton(buttonText: String, buttontext2: String) {
    // 覆盖所有常用状态的标题，避免残留默认值
    button1.setTitle(buttonText, for: .normal)
    button1.setTitle(buttonText, for: .highlighted)
    button1.setTitle(buttonText, for: .selected)
    button2.setTitle(buttontext2, for: .normal)
    button2.setTitle(buttontext2, for: .highlighted)
    button2.setTitle(buttontext2, for: .selected)
    // 强制立即更新布局，消除渲染延迟
    button1.layoutIfNeeded()
    button2.layoutIfNeeded()
}

• 适配UIButtonConfiguration的更新逻辑
  如果你的项目适配iOS15及以上，且按钮使用了Configuration配置，必须通过修改configuration的方式更新标题，避免和Storyboard配置冲突：

// 修改单个按钮标题的示例
var config = button1.configuration
config?.title = "text1"
button1.configuration = config

• 在复用前清理状态
  在自定义cell的prepareForReuse方法中提前重置按钮标题，避免cell复用时残留旧状态：

override func prepareForReuse() {
    super.prepareForReuse()
    button1.setTitle(nil, for: .normal)
    button2.setTitle(nil, for: .normal)
}

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