Swift开发中如何将原有Storyboard替换为新导入的独立项目Storyboard

前置防护 #

• 先将当前项目所有代码、原有Storyboard提交到版本控制，打上可快速回滚的版本标签，避免操作失误导致原有配置丢失
• 将团队交付的新Storyboard拖入项目导航栏，导入时勾选「Copy items if needed」，并确认文件已关联到当前App的运行Target。此时项目下会同时存在新旧两个Storyboard文件，暂不删除任何原有文件

核心替换操作（兼顾保留原有segue的需求） #

• 打开项目Info.plist配置项，临时将Main storyboard file base name的值修改为新导入的Storyboard文件名，确保App启动时能正常加载新Storyboard的入口配置做校验
• 同时打开新、旧两个Storyboard文件，全选新Storyboard内所有已完成设计的View Controller、界面布局内容，通过复制粘贴的方式导入到旧Storyboard的画布中
• 粘贴时Xcode会弹出场景匹配提示，选择「当存在相同Storyboard ID的场景时，替换原有场景的UI内容」，这个操作只会替换界面层的布局元素，不会直接清除原有场景绑定的类配置、已配置的segue跳转规则
• 逐个核验场景匹配情况：对于Storyboard ID和旧文件完全一致的控制器场景，手动删除场景下原来残留的旧UI子控件，将新粘贴的UI内容挂载到对应控制器的根视图下，保证界面层级和控制器的绑定关系不混乱

冗余清理与配置恢复 #

• 确认所有新UI都成功迁移到旧Storyboard后，将独立的新Storyboard文件从项目中移除，选择「Remove Reference」即可（本地文件保留在磁盘上，后续团队更新设计时可直接二次导入，不需要重复拖入）
• 将Info.plist中的Main storyboard file base name配置值改回原有的旧Storyboard文件名，恢复项目的默认加载逻辑
• 此时打开原Storyboard即可验证：所有原有配置的segue跳转逻辑、控制器类绑定关系全部保留，仅界面UI部分完全替换为新设计的内容

后续重连阶段的提效技巧 #

• 重新关联IBOutlet、IBAction时，打开Xcode辅助编辑功能，分栏一侧显示控制器代码、一侧显示对应Storyboard场景，直接拖拽连线即可，不需要逐行查找控件
• 原有配置的segue不需要全部删除重配，只要源、目标控制器的Storyboard ID和原有配置一致，就可以直接复用跳转逻辑，仅需在prepare(for:sender:)方法中补充新UI对应的参数传递逻辑即可

关键避坑点：绝对不要直接用新Storyboard文件整体覆盖原有Storyboard文件。因为segue配置是存储在Storyboard的XML节点和场景哈希值上的，整文件覆盖后所有节点标识会完全变化，原有配置的所有连线都会彻底失效，反而增加返工成本。

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