Swift扩展：为Logger类实现带文件行号的方法重载

可行性结论 #

完全可行，不需要任何运行时动态补丁，仅通过Swift编译期的方法重载特性就能实现需求，且移除扩展后代码可正常编译运行。

具体实现方案 #

通过扩展Logger类，新增一个接受String类型参数的debug重载方法，利用Swift内置的编译期常量#fileID、#line、#function自动注入元数据，再调用系统原生的debug方法输出格式化后的日志：

import OSLog

extension Logger {
    // 重载debug方法，优先匹配String类型参数
    func debug(_ message: String, 
               file: StaticString = #fileID, 
               line: UInt = #line, 
               function: StaticString = #function) {
        // 嵌入元数据到日志内容中
        let formattedMessage = "[\(file):\(line) \(function)] \(message)"
        // 调用系统原生debug方法，同时传递元数据参数
        self.debug(OSLogMessage(stringLiteral: formattedMessage), 
                   file: file, 
                   line: line, 
                   function: function)
    }
}

原理说明 #

1. 重载优先级：系统原生Logger.debug的第一个参数是OSLogMessage类型，我们新增的方法接受更具体的String类型。当调用logger.debug("日志内容")时，Swift编译器会优先匹配String参数的重载方法，而非需要隐式转换为OSLogMessage的原生方法。
2. 编译期元数据注入：#fileID、#line、#function是编译期常量，会自动替换为调用处的文件名、行号和函数名，无需运行时计算。
3. 兼容性保障：当移除该扩展后，原有logger.debug("日志内容")的代码会自动触发String到OSLogMessage的隐式转换，调用系统原生方法，完全不影响编译和运行。

补充：兼容插值日志场景 #

如果需要支持带插值的日志（如logger.debug("用户ID: \(userId)")），由于这种写法会直接构造OSLogMessage实例，无法匹配String参数重载。此时可以新增一个接受@autoclosure闭包的重载方法，兼容插值场景：

extension Logger {
    func debug(_ message: @autoclosure () -> String,
               file: StaticString = #fileID,
               line: UInt = #line,
               function: StaticString = #function) {
        let formattedMessage = "[\(file):\(line) \(function)] \(message())"
        self.debug(OSLogMessage(stringLiteral: formattedMessage),
                   file: file,
                   line: line,
                   function: function)
    }
}

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