iOS Swift如何实现应用及私有框架NSLog调用重定向到文件

两个问题的核心结论先明确：

1. 可以将主App、私有框架所有NSLog输出统一重定向到同一个文件，最便捷的方案是重定向stderr输出流
2. 重定义NSLog的方式只能覆盖你自有代码中的NSLog调用，无法捕获私有框架内的原生NSLog输出，不适合全量统一捕获的需求

方案1：重定向stderr输出（全量捕获通用方案） #

NSLog默认会将内容输出到标准错误流（stderr），只要重定向stderr的输出目标到指定文件，所有走系统NSLog实现的输出（包括私有框架的调用）都会自动写入该文件，无需修改任何现有NSLog调用代码。

你可以在App启动入口（比如application(_:didFinishLaunchingWithOptions:)方法中）调用如下方法开启重定向：

func redirectAllNSLogToFile() {
    // 定义日志文件存储路径，这里存在Documents目录下
    let docDir = NSSearchPathForDirectoriesInDomains(.documentDirectory, .userDomainMask, true)[0] as NSString
    let logFilePath = docDir.appendingPathComponent("total_app_logs.log")
    print("日志文件路径：\(logFilePath)") // 开发阶段可以打印路径方便查找文件
    
    // 重定向stderr到指定文件，a+代表追加写入、文件不存在则创建
    freopen(logFilePath.cString(using: .utf8), "a+", stderr)
    
    // 如果需要同时捕获Swift的print/debugPrint输出（默认输出到stdout），可以追加这一行
    // freopen(logFilePath.cString(using: .utf8), "a+", stdout)
}

该方案的特点：

• 优点：无侵入性，全量覆盖所有NSLog调用，性能开销极低
• 缺点：默认是追加写入，需要自行实现日志分片、过期清理逻辑；Debug环境下开启后Xcode控制台将不再显示NSLog输出，如果需要同时保留控制台输出，可以用dup复制原始stderr文件描述符，写入文件的同时同步输出到原stderr即可

方案2：重定义NSLog（仅适用于自定义自有日志逻辑） #

如果你需要给日志增加自定义规则（比如加统一前缀、过滤日志级别、同步上报等），可以重定义NSLog的实现，但该方式仅对自有代码中的NSLog调用生效，私有框架编译时已经链接了系统原生NSLog实现，不会走你重定义的逻辑。

Swift中实现自定义全局NSLog的示例代码：

// 全局函数覆盖系统NSLog，仅对当前模块的调用生效
func NSLog(_ format: String, _ args: CVarArg...) {
    // 自定义日志格式，比如加时间戳
    let dateFormatter = DateFormatter()
    dateFormatter.dateFormat = "yyyy-MM-dd HH:mm:ss.SSS"
    let timePrefix = dateFormatter.string(from: Date())
    let finalLog = String(format: "\(timePrefix) \(format)", arguments: args)
    
    // 自定义逻辑：同时输出到控制台、写入本地文件、上报到服务端等
    print(finalLog)
    customWriteLogToFile(finalLog)
}

// 自定义写文件方法自行实现即可
private func customWriteLogToFile(_ logContent: String) {
    // 实现写入逻辑...
}

该方案的特点：

• 优点：灵活度极高，可以完全自定义日志的处理逻辑
• 缺点：无法捕获私有框架的NSLog输出，无法满足全量统一重定向的需求

注意事项 #

• 日志文件要做大小上限控制，避免长期运行占用过多用户存储空间，建议实现按日期/大小分片、定期清理过期日志的逻辑
• 上述方案仅对系统NSLog生效，如果你项目中用了iOS 10+推出的OSLog体系，需要单独适配OSLog的收集逻辑

内容的提问来源于stack exchange，提问作者Stéphan Bordera