如何在Storyboard界面构建器中批量编辑？批量为20+Storyboard添加Safe Area Layout Guide

嘿，我之前刚帮团队处理过差不多的情况——20多个Storyboard要适配Safe Area，一个个手动改真的要疯！下面给你分享几个实用的批量操作方法，从可视化界面的小技巧到高效的源码替换，再到一劳永逸的自动化脚本都有：

1. Interface Builder可视化批量提速技巧（适合先熟悉流程） #

虽然IB没有直接跨Storyboard的一键批量按钮，但我们可以用些小技巧把效率拉满：

• 先把所有需要修改的Storyboard都在Xcode里用Tab标签打开（或者拖到同一个窗口）
• 打开第一个Storyboard，在左侧Document Outline里按住Command键多选所有需要开启Safe Area的ViewController根View
• 切换到右侧Attributes Inspector面板，找到「Use Safe Area Layout Guides」选项勾选——这会一次性给选中的所有View开启Safe Area
• 接下来处理旧约束：同样多选所有绑定了Top Layout Guide/Bottom Layout Guide的约束，在Size Inspector里把关联对象从旧的Layout Guide改成Safe Area.top/Safe Area.bottom
• 重复这个流程到每个Storyboard，虽然还是要逐个打开，但比单个修改快至少3倍

2. 源码批量替换（最适合20+ Storyboard的高效方案） #

每个Storyboard本质是XML文件，用Xcode的全局查找替换可以跳过IB的可视化限制，直接批量修改：

步骤1：批量开启Safe Area #

• 打开Xcode的全局查找（快捷键Shift+Command+F），切换到「Find」标签
• 输入正则表达式：<view.*?class="UIView".*?>（匹配所有ViewController的根View节点）
• 切换到「Replace」标签，输入：<view$& safeAreaLayoutGuides="YES"（给匹配的节点添加Safe Area属性）
• 先点击「Find」确认所有匹配项都是目标View，再点击「Replace All」（一定要先备份项目或用Git提交当前版本！）

步骤2：批量替换旧Layout Guide约束 #

• 继续用全局查找替换，把所有旧的Layout Guide引用换成Safe Area：
  • 查找内容：topLayoutGuide，替换为：safeAreaLayoutGuide
  • 查找内容：bottomLayoutGuide，替换为：safeAreaLayoutGuide
• 替换后可以随机打开几个Storyboard检查，确保约束没有冲突

3. 自动化脚本（一劳永逸的方案） #

如果以后还要处理类似的适配，或者你觉得手动替换还是麻烦，写个简单的shell脚本就能一键搞定所有Storyboard：

#!/bin/bash

# 遍历当前目录及子目录下所有.storyboard文件
find . -name "*.storyboard" -type f | while read file; do
  echo "正在处理: $file"
  # 给根View添加safeAreaLayoutGuides属性
  sed -i '' 's/<view\(.*\)class="UIView"\(.*\)>/<view\1class="UIView"\2 safeAreaLayoutGuides="YES">/' "$file"
  # 替换旧的top/bottom Layout Guide引用
  sed -i '' 's/topLayoutGuide/safeAreaLayoutGuide/g' "$file"
  sed -i '' 's/bottomLayoutGuide/safeAreaLayoutGuide/g' "$file"
done

echo "所有Storyboard已完成Safe Area适配！"

• 把脚本保存为update_safe_area.sh，放到项目根目录
• 打开终端，运行chmod +x update_safe_area.sh赋予执行权限
• 最后运行./update_safe_area.sh即可自动处理所有Storyboard

关键注意事项 #

• 无论用哪种方法，先备份项目或提交Git版本是必须的，避免修改出错无法回滚
• 替换完成后一定要逐个打开Storyboard检查，复杂布局可能会出现约束冲突，需要手动微调
• 如果项目中有自定义View或特殊约束，可能需要调整正则表达式或脚本的匹配规则

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