如何在新版Xcode中完成旧版Swift代码的版本转换

以下是经过实测可用的几种方案，按操作成本从低到高排序：

• 方案1：绕过系统版本限制运行Xcode 10.1，保留原生转换能力
  不需要升级或替换现有新版Xcode，直接修改留存的Xcode 10.1安装包即可在Monterey及更新版本系统运行：
  1. 找到Xcode 10.1的app文件，右键选择「显示包内容」，打开Contents/Info.plist文件
  2. 找到Minimum system version字段，将默认的10.13/10.14修改为当前系统对应的版本号（Monterey填12.0即可），保存文件
  3. 打开终端执行sudo xattr -cr 「Xcode 10.1的实际存放路径」，绕过系统签名校验和隔离限制
     操作完成后即可正常打开Xcode 10.1，用自带的高准确率转换工具把Swift 2代码转成Swift 4格式，导出的项目再用新版Xcode打开做少量API适配即可正常调试。操作前建议备份原Xcode 10.1安装包，避免修改失误导致文件损坏。
• 方案2：调用Swift官方工具链逐版本迁移，无需依赖旧版Xcode
  如果不想修改旧版Xcode文件，可以直接在新版Xcode中安装历史版本Swift工具链完成转换：
  1. 在Xcode设置的Components面板中下载Swift 3.0、Swift 4.0版本的工具链，通过Xcode顶部菜单栏的Toolchains选项切换对应版本
  2. 终端切到旧项目的根目录（和.xcodeproj文件同层级），切换到Swift 3.0工具链后执行swift migrate，自动完成Swift 2到Swift 3的语法转换
  3. 依次切换到Swift 4.0、Swift 5.0工具链重复执行迁移命令，逐版本修正语法问题，禁止跨大版本直接转换，否则会出现大量语法识别错误、逻辑转换偏差
  4. 全版本迁移完成后切回最新版Swift工具链，在新版Xcode中修复剩余的少量系统API适配问题即可。
• 方案3：模块化手动适配（适合代码量较小的单文件/小型项目）
  对于代码量不大的项目，不需要折腾工具链：先在新版Xcode中新建空白项目，将旧代码的源文件逐组拖入，把Build Settings中的Swift Language Version先临时设为Swift 3，按照Xcode抛出的编译报错逐行修正即可。Swift 2到现代Swift版本的核心语法变动集中在可选值拆包规则、GCD调用写法、Selector声明格式、集合类API命名这几个固定范围，实际适配工作量远低于预期。

避坑提示：不要直接把Swift 2格式的项目拖入最新版Xcode触发自动转换，跨度过大的版本差会导致内置转换工具直接报错无法运行，即使强制触发转换也会生成大量存在逻辑错误的代码，逐版本过渡的转换准确率最高。

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