如何在Xcode的Swift Package Manager项目中输出控制台日志

修复控制台输出不显示的问题 #

• 确保处于Debug编译模式：Release模式下Swift会自动优化掉print语句，切换到Debug模式（Xcode顶部工具栏选择Debug）再运行。
• 打开Xcode控制台：通过View > Debug Area > Activate Console或快捷键Shift + Command + Y调出控制台，避免遗漏输出。
• 改用os_log替代print：print容易被编译优化，而os_log更稳定，且支持日志分类筛选。示例代码：

import OSLog

// 定义日志对象，subsystem和category替换为你的包信息
private let apiLogger = Logger(subsystem: "com.your.spmpackage", category: "APIFetch")

// 在数据获取完成后输出
func fetchAPIData() async throws {
    let data = try await yourAPICall()
    apiLogger.debug("Raw API data: \(data)")
    apiLogger.debug("Parsed model: \(parsedModel)")
}

在控制台中可以通过搜索subsystem或category快速定位你的日志。

简便的API数据验证方法 #

1. 编写单元测试（最推荐） #

在SPM包中添加测试目标，直接在测试用例中调用API并验证数据，测试中的输出会在测试控制台显示，同时还能自动验证数据正确性。示例：

import XCTest
@testable import YourSPMPackage

final class APIDataTests: XCTestCase {
    func testFetchAndValidateAPIData() async throws {
        let service = APIService()
        let model = try await service.fetchData()
        
        // 输出数据到测试控制台
        print("Fetched model: \(model)")
        
        // 验证数据结构
        XCTAssertNotNil(model.id, "ID should not be nil")
        XCTAssertFalse(model.title.isEmpty, "Title should not be empty")
    }
}

运行测试后，在Xcode的测试报告控制台就能看到输出，同时自动校验数据是否符合预期。

2. 断点调试查看数据 #

在API数据解析完成的代码行设置断点，运行App触发API调用后，断点暂停时，在Xcode左侧的变量视图中直接查看数据模型的所有属性，无需编写任何输出代码，直观高效。

3. 添加调试回调闭包 #

在SPM的API服务类中新增一个可选的调试闭包，App项目中只需实现该闭包即可接收并输出数据，无需添加视图。示例：

// SPM包中的APIService类
class APIService {
    // 定义调试闭包
    var onDebugDataReceived: ((DataModel) -> Void)?
    
    func fetchData() async throws -> DataModel {
        let rawData = try await URLSession.shared.data(from: apiURL).0
        let model = try JSONDecoder().decode(DataModel.self, from: rawData)
        
        // 触发调试回调
        onDebugDataReceived?(model)
        
        return model
    }
}

// App项目中使用时
let apiService = APIService()
// 设置调试回调输出数据
apiService.onDebugDataReceived = { model in
    print("Debug API data: \(model)")
}
// 调用API
Task {
    try await apiService.fetchData()
}

内容的提问来源于stack exchange，提问作者Laura García