查看 iOS 设备实时日志与崩溃日志的方法

iOS 设备和应用日志分为实时运行时日志（如 NSLog、os_log）和崩溃日志（Crash Reports）。以下为详细的查看和分析方法。

使用 Xcode 查看设备日志

连接设备到 Mac，打开 Xcode 选择 Window > Devices and Simulators。选中设备后点击 View Device Logs，可查看崩溃日志（包括系统级和应用级崩溃）。实时日志需通过调试模式运行应用，在 Xcode 底部调试控制台输出。

实时日志需确保应用以 Debug 模式运行，且勾选 Edit Scheme > Run > Arguments 中的 OS_ACTIVITY_MODE 环境变量设为 disable（过滤冗余系统日志）或保持默认。

使用 macOS 控制台应用

打开 Console.app（位于 /Applications/Utilities/），通过 USB 连接设备后，左侧选择设备名称。实时日志会动态显示，支持过滤关键词（如进程名或崩溃类型）。崩溃日志通常存储在 Crash Reports 或 Diagnostic Reports 分类下。

控制台的高级筛选语法示例：

• process == "YourApp" 筛选特定应用日志
• eventMessage contains "error" 筛选含关键词的日志

提取崩溃日志的符号化

崩溃日志（.crash 或 .ips 文件）需符号化才能可读。将设备日志导出后，使用 Xcode 命令行工具 symbolicatecrash：

1. 确认 Xcode 路径：

   export DEVELOPER_DIR="/Applications/Xcode.app/Contents/Developer"
   

2. 执行符号化（需对应应用的 dSYM 文件）：

   /Applications/Xcode.app/Contents/SharedFrameworks/DVTFoundation.framework/Versions/A/Resources/symbolicatecrash log.crash > log_symbolicated.crash
   

通过代码捕获崩溃信息

在应用中集成 NSSetUncaughtExceptionHandler 捕获未处理的异常：

func setCrashHandler() {
    NSSetUncaughtExceptionHandler { exception in
        let stackSymbols = exception.callStackSymbols
        UserDefaults.standard.set(stackSymbols, forKey: "LastCrashLog")
    }
}

对于 Swift 错误（如 fatalError），需通过 signal 捕获信号量（如 SIGABRT）。

第三方工具集成

PLCrashReporter 或 Firebase Crashlytics 可自动化日志收集：

1. 集成 Firebase：

   FirebaseApp.configure()
   Crashlytics.crashlytics().setCrashlyticsCollectionEnabled(true)
   

2. 手动记录关键事件：

   Crashlytics.crashlytics().log("User action: button tapped")
   

分析系统日志条目

系统日志条目通常以 <Notice> 或 <Error> 标记优先级。关键字段包括：

• Timestamp: 日志时间戳
• Subsystem: 如 com.apple.UIKit
• Category: 具体操作分类
• Message: 日志内容

过滤系统日志示例：

log show --predicate 'eventMessage contains "Springboard"' --last 1h

无线日志收集

启用设备的 Settings > Privacy & Security > Analytics & Improvements > Share iPhone Analytics，日志会上传至 Apple 并可从 iCloud 下载。开发者账户可访问 App Store Connect > TestFlight 下的崩溃日志。

日志格式解析示例

典型崩溃日志片段：

Thread 0 Crashed:
0   libsystem_kernel.dylib        0x00000001c5b8c0dc __pthread_kill + 8
1   libsystem_pthread.dylib       0x00000001d5f8f094 pthread_kill + 292
2   libsystem_c.dylib            0x000000018e5f3fd4 abort + 104
3   YourApp                       0x0000000100a1238c specialized ViewController.crashMethod() + 144

解析要点：

• 地址偏移量（如 0x0000000100a1238c）需匹配 dSYM 文件
• 最后一行显示崩溃的具体方法和代码位置

注意事项

• 发布到 App Store 的应用需在 Xcode > Organizer > Archives 中下载 dSYM 文件。
• iOS 15+ 的系统日志可能需要设备启用 Settings > Developer > Logging 的定制配置。
• 实时日志输出量过大时，建议使用 os_log 的分级控制（如 .debug、.error）。