macOS定时任务日志需结合三类信息交叉验证：自定义标准输出/错误文件、统一日志（log命令）、launchctl实时状态；关键排查点包括权限、绝对路径、GUI访问限制及SIP防护。
macos 的定时任务日志不集中存储，而是分散在配置文件指定路径、系统日志和 launchd 运行状态中。要真正看清任务是否执行、何时失败、错在哪，得结合三类信息交叉验证：标准输出/错误文件、system.log 或 unified logging（log 命令）、以及 launchctl 的实时状态反馈。
查看任务自己生成的日志文件
这是最直接的线索。你在 plist 中明确设置了 StandardOutPath 和 StandardErrorPath，比如：
-
/Users/yourname/logs/backup.out—— 正常输出内容（如“备份完成”） -
/Users/yourname/logs/backup.err—— 错误堆栈、权限拒绝、路径不存在等报错
只要配置正确且文件路径可写，脚本每次运行都会追加记录。用终端打开看：
tail -n 20 /Users/yourname/logs/backup.outtail -n 20 /Users/yourname/logs/backup.err
查系统统一日志（Unified Logging）
launchd 本身及子进程的启动、失败、唤醒行为会记入 macOS 统一日志系统。尤其当脚本没写自定义日志，或根本没触发时，这里能告诉你“任务压根没跑”：
- 查某任务最近的 launchd 操作：log show --predicate 'subsystem == "com.apple.launchd" AND eventMessage CONTAINS "com.example.dailybackup"' --last 1h
- 查所有 launchd 相关错误（含权限、加载失败）：log show --predicate 'subsystem == "com.apple.launchd" AND type == "error"' --last 24h | head -20
- 如果任务因合盖唤醒失败，常见提示是 "Not running: job is disabled or not scheduled" 或 "Could not start job: 5"（权限错误）
确认任务当前是否真正在运行
launchctl list 只显示是否被加载，不能说明是否活跃。可靠判断方式是：
- 查用户级任务状态：launchctl print gui/$(id -u)/com.example.dailybackup → 看 state = running 才算活的
- 查下次计划触发时间（仅限 StartCalendarInterval）：launchctl print gui/$(id -u)/com.example.dailybackup | grep -A3 "NextRun"
- 若 state 是 waiting 或 throttled，说明还没到点、或刚失败被限频；若为 failed，立刻去 .err 文件和 unified log 查原因
调试常见日志断点
很多任务“看似配置对了却没动静”，问题往往卡在几个固定环节：
-
脚本没权限：即使 plist 加载成功，
chmod +x /path/to/script.sh缺失会导致 silent fail（只在 .err 或 unified log 报 “Operation not permitted”） -
路径不绝对：脚本里用了
cd ~/Documents或python main.py—— launchd 不继承 shell 的 ~ 展开和 $PATH，必须全写成/Users/xxx/Documents和/usr/bin/python3 -
GUI 访问限制：LaunchAgent 能访问 GUI，但 LaunchDaemon 默认不能；若脚本要弹窗或操作 Finder，必须用
gui/501/而非system/前缀调用 - SIP 或权限隔离：往 /System、/usr/bin 写东西会被阻止；日志路径建议选 ~/Library/Logs 或 /var/log（需 root 权限）
