大规模Swift代码库中批量替换.doOnComplete {}为.do(onComplete: {})的最优方案

嘿，面对大型Swift代码库的批量代码修改需求，手动改确实是噩梦！我给你几个从易到难、覆盖不同场景的最优方案，你可以根据自己的情况选：

1. Xcode内置正则查找替换（最快上手，适合绝大多数场景） #

Xcode自带的全局查找替换功能配合正则表达式，是处理这类问题最便捷的方式，不需要额外工具：

• 按下Cmd+Shift+F打开全局查找面板
• 点击查找框右侧的Aa按钮，切换到Regular Expression模式
• 在「查找」框输入正则：\.doOnComplete\s*\{(.*?)\}
• 在「替换」框输入：.do( onComplete: { $1 } )
• 先点击「Find」预览所有匹配项，确认没有误匹配后，点击「Replace All」完成批量修改

小贴士：如果你的闭包内容跨多行，记得在查找面板的Options里勾选「Dot Matches Newlines」，这样正则就能匹配多行的闭包内容了。

2. SwiftSyntax（最可靠，适合复杂语法场景） #

如果代码里存在大量格式不规范的情况（比如嵌套闭包、尾随闭包、空格随意），正则可能会出现误匹配或漏匹配。这时候用Swift官方的SwiftSyntax工具是最稳妥的——它能直接解析Swift的抽象语法树（AST），精准定位并修改代码。

简单实现步骤： #

1. 创建一个新的Swift命令行项目，通过Swift Package Manager引入SwiftSyntax依赖
2. 编写代码遍历目标目录下的所有.swift文件，解析语法树并替换目标调用：

import SwiftSyntax
import SwiftSyntaxBuilder

func replaceDoOnComplete(in fileURL: URL) throws {
    let sourceFile = try SyntaxParser.parse(fileURL)
    
    let rewriter = SyntaxRewriter { node in
        // 定位到doOnComplete的函数调用
        guard let functionCall = node.as(FunctionCallExprSyntax.self),
              let callee = functionCall.callee.as(MemberAccessExprSyntax.self),
              callee.name.text == "doOnComplete" else {
            return node
        }
        
        // 构建新的do(onComplete:)调用
        let newCallee = MemberAccessExprSyntax(base: callee.base, name: "do")
        let newArguments = TupleExprElementListSyntax {
            TupleExprElementSyntax(
                label: "onComplete",
                expression: functionCall.arguments.first!.expression
            )
        }
        let newCall = FunctionCallExprSyntax(
            callee: newCallee,
            leftParen: .leftParenToken(),
            arguments: newArguments,
            rightParen: .rightParenToken()
        )
        
        return newCall
    }
    
    let modifiedSource = rewriter.visit(sourceFile).description
    try modifiedSource.write(to: fileURL, atomically: true, encoding: .utf8)
}

// 遍历目录下所有.swift文件
let targetDir = URL(fileURLWithPath: "./YourProjectDir")
let enumerator = FileManager.default.enumerator(at: targetDir, includingPropertiesForKeys: nil)!
for case let fileURL as URL in enumerator where fileURL.pathExtension == "swift" {
    try replaceDoOnComplete(in: fileURL)
}

这个方法能完美处理各种复杂的Swift语法情况，不会出现正则的局限性问题，适合超大型、代码格式多样的项目。

3. 命令行工具（sed，适合简单规范场景） #

如果你的代码格式非常统一，所有.doOnComplete的闭包都是单行写法，也可以用sed命令快速批量处理：

# 遍历当前目录及子目录下的所有.swift文件，批量替换
find . -name "*.swift" -type f -exec sed -i '' 's/\.doOnComplete\s*{/\.do( onComplete: {/g' {} \;

不过要注意：sed对多行匹配的支持很差，如果闭包内容跨多行，这个命令就会失效，所以只适合简单场景。

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