macos 中需用 launchd 实现合盖睡眠后仍能唤醒执行的定时任务：用户级用 launchagents（startcalendarinterval/startinterval），系统级用 launchdaemons，调试依赖日志与 launchctl 命令。
如果您希望在 macOS 系统中实现脚本或程序的精准定时执行，且要求任务在合盖睡眠后仍能按计划唤醒运行，则需依赖系统原生服务管理框架 launchd。以下是配置 launchd 定时任务的具体方法：
一、使用 LaunchAgents 配置用户级定时任务
LaunchAgents 适用于当前用户登录状态下运行的任务，支持 StartCalendarInterval（指定时刻）和 StartInterval（间隔秒数）两种触发方式，任务可随用户会话自动加载，适合 Python 脚本、Shell 脚本等用户级自动化需求。
1、打开终端，进入用户 LaunchAgents 目录：cd ~/Library/LaunchAgents。
2、创建 plist 配置文件：nano com.example.pythonjob.plist。
3、输入以下内容（请将 /Users/yourname/script.py 替换为实际 Python 脚本路径）：
4、保存并退出 nano（Control+O → Enter → Control+X）。
5、加载任务：launchctl load com.example.pythonjob.plist。
6、启用任务启动：launchctl start com.example.pythonjob。
二、使用 LaunchDaemons 配置系统级定时任务
LaunchDaemons 在系统启动时即加载，不依赖任何用户登录，适合需要在无人值守、合盖休眠后仍能唤醒执行的关键任务，例如日志轮转、数据同步或远程健康检查。
1、切换至系统级 LaunchDaemons 目录：sudo cd /Library/LaunchDaemons。
2、创建守护进程配置文件：sudo nano com.example.systemjob.plist。
3、填入以下内容（注意需使用绝对路径，并确保脚本具有执行权限）：
4、赋予配置文件 root 权限：sudo chown root:wheel com.example.systemjob.plist。
5、加载并启用：sudo launchctl load /Library/LaunchDaemons/com.example.systemjob.plist。
三、使用 StartInterval 实现周期性轮询任务
当任务无需严格对齐钟表时间，而只需每固定秒数执行一次（如每 5 分钟检测网络状态），StartInterval 比 StartCalendarInterval 更轻量、更可靠，尤其适用于后台监控类脚本。
1、编辑任一已存在的 plist 文件（如 com.example.pythonjob.plist），删除 StartCalendarInterval 字典块。
2、添加以下键值对（表示每 300 秒执行一次）：
3、确保脚本本身具备幂等性，避免重复执行引发冲突。
4、重新加载配置：launchctl unload com.example.pythonjob.plist && launchctl load com.example.pythonjob.plist。
四、调试与日志验证
launchd 自动捕获标准输出与错误输出至指定日志路径，也可通过 launchctl 命令实时查看任务状态与最近运行记录，是排查“任务未触发”或“脚本静默失败”的核心手段。
1、查看所有已加载任务：launchctl list | grep example。
2、查看某任务的详细状态：launchctl print gui/$(id -u)/com.example.pythonjob。
3、实时追踪日志（以标准输出为例）：tail -f /Users/yourname/pythonjob.log。
4、手动触发一次任务用于测试：launchctl kickstart -k gui/$(id -u)/com.example.pythonjob。
5、若任务因权限或路径错误失败，launchd 会在 StandardErrorPath 中记录具体错误信息，例如 No such file or directory 或 Permission denied。
