如何在命令行强制Xcode更新String Catalog？

一、用命令行强制触发String Catalog更新 #

Xcode编译时的自动更新不稳定，推荐使用xcodebuild的extractLocStrings动作，它会全量扫描代码中的本地化字符串，强制更新Localizable.xcstrings文件，比增量编译更可靠：

xcodebuild extractLocStrings -project YourProject.xcodeproj -target YourTarget -localizationPath ./Resources/Localizations

• 替换YourProject.xcodeproj和YourTarget为你的项目和目标名称
• -localizationPath指定Localizable.xcstrings所在的目录，确保路径与项目实际结构一致

二、修复配置遗漏点 #

之前设置LOCALIZATION_PREFERS_STRING_CATALOGS和SWIFT_EMIT_LOC_STRINGS无效，可能是遗漏了以下配置：

• 检查LOCALIZATION_STRING_CATALOG_OUTPUT_DIR：必须正确指向Localizable.xcstrings的存放目录，否则Xcode无法定位更新文件
• 全局开启SWIFT_EMIT_LOC_STRINGS：确保所有Target（包括测试Target）的该选项都设为YES，避免子Target的配置覆盖主Target设置

三、CI集成方案 #

在CI流程中加入以下步骤，确保未提交的String Catalog变更被检测到：

1. 先执行extractLocStrings命令更新文件
2. 用git status检查是否有未提交的Localizable.xcstrings变更，若有则终止流程并提示开发者提交

示例CI脚本：

# 强制更新String Catalog
xcodebuild extractLocStrings -project YourProject.xcodeproj -target YourTarget -localizationPath ./Resources/Localizations

# 检查Git状态，检测未提交的本地化文件变更
if git status --porcelain | grep -q "Localizable.xcstrings"; then
    echo "错误：Localizable.xcstrings存在未提交的变更，请提交后再推送。"
    exit 1
fi

补充说明 #

Xcode默认的编译时更新是增量式的，只会扫描变更过的文件，所以容易出现更新滞后。而extractLocStrings是全量扫描所有代码中的本地化字符串，能保证Localizable.xcstrings与代码完全同步。

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