Mac系统日志排查需用“控制台”App,支持实时日志流、活动分组、关键词搜索、日志导出及访达路径跳转五种方法,覆盖异常诊断全流程。

如果您需要排查 macOS 系统异常、应用崩溃或硬件响应问题,系统日志文件可提供关键运行时信息。Mac 的“控制台”App 是官方推荐的查看与分析工具,支持按活动、进程、时间范围等维度筛选原始日志流。以下是多种有效查看和分析系统日志的方法:
一、通过“控制台”主界面查看实时系统日志
该方法适用于快速观察当前系统正在生成的日志条目,无需预设条件即可捕获新出现的警告、错误或调试信息。启动后默认加载本机最近日志,并持续接收新条目。
1、在 Launchpad 或“应用程序”文件夹中打开控制台 App。
2、确认左侧边栏中已显示设备列表;若未显示,点按顶部工具栏中的边栏按钮(图标为三道横线)。
3、在边栏中选择您的 Mac 名称(通常为本机名称),确保其处于高亮状态。
4、点按工具栏中的开始按钮(若按钮呈灰色,请先点按该按钮激活流式传输)。
5、窗口中央将滚动显示实时日志,每条记录包含时间戳、进程名、子系统及消息内容。
二、使用“活动”视图按关联行为分组查看日志
系统会将同一操作触发的多个日志条目自动归类为一个“活动”,例如一次 App 启动、网络连接建立或电源状态切换。此视图有助于识别因果链,避免在海量条目中手动拼接上下文。
1、在“控制台”窗口顶部工具栏中,点按活动按钮(图标为两个重叠圆圈)。
2、若“活动”按钮不可用,请先点按开始按钮启用日志流。
3、等待数秒,待活动列表加载完成后,在主窗口上方区域选择一个活动条目。
4、该活动对应的所有日志将集中显示在窗口底部面板中。
5、如需查看某活动内部更细粒度的操作分支,点按活动条目右侧的展开箭头;如需收起冗余细节,点按隐藏按钮。
三、通过搜索功能定位特定关键词或进程日志
当已知错误现象(如“Wi-Fi disconnection”)、崩溃进程名(如“Safari”)或系统服务标识(如“com.apple.networking”)时,可直接执行精准文本匹配,大幅缩短排查路径。
1、在“控制台”窗口顶部的搜索栏中,键入目标关键词,例如kernel panic或bluetoothd。
2、按下Return 键执行搜索,匹配结果即时呈现于主窗口。
3、如需限定搜索范围,点按搜索过滤条件旁的下拉箭头,选取属性(如“进程”、“信息类型”或“日期与时间”)。
4、若要排除干扰项,可在搜索栏中输入-error(减号加关键词)以隐藏含该词的条目。
5、完成有效搜索后,可点按搜索栏右侧的+ 按钮将其保存为命名搜索,便于后续复用。
四、导出日志条目或整个活动用于离线分析
当需将日志提交给技术支持、跨设备比对或存档备案时,可将选定内容导出为文本文件。导出内容保留原始时间戳、进程ID及完整消息体,兼容标准日志分析工具。
1、在“控制台”中选中一条或多条日志(按住 Command 键可多选),或在“活动”视图中选中一个活动条目。
2、点按工具栏中的共享按钮(图标为方形带向上箭头)。
3、在弹出菜单中选取存储为文件…选项。
4、在保存对话框中,指定文件名与位置,格式默认为.log文本文件。
5、点击存储,文件即生成并可使用文本编辑器或终端命令进一步处理。
五、定位并访问日志文件在访达中的实际存储路径
macOS 将结构化日志统一存于 /var/db/uuidtext/ 和 /var/log/ 等受保护目录下。“控制台”本身不直接暴露路径,但可通过界面操作跳转至对应文件所在访达位置,适用于需手动检查权限、备份原始文件或执行命令行分析的场景。
1、在“控制台”左侧边栏中,点按日志报告类别;若未显示,请先点按边栏按钮并勾选该选项。
2、在“日志报告”列表中,找到目标日志文件(如 system.log 或 unified_logging_*.log)。
3、右键点按该文件,在快捷菜单中选取在访达中显示。
4、访达窗口将自动打开,并高亮选中该日志文件。
5、若访达提示无权访问该文件夹,请确认已使用管理员账户登录;必要时可在终端中执行 sudo 命令配合 log show 提取内容。

















