macos终端管理计划任务的核心是launchctl工具，通过分层命令可查看、启用、禁用、重载launchagents和launchdaemons任务，并结合plist配置文件定位、调试及日志排查。
直接用终端查看和管理 macos 的计划任务，核心是 launchctl 工具，配合不同层级的 plist 配置文件。系统没有“总览面板”，但可通过命令分层定位、加载、停用或调试所有定时类任务（包括 launchagents 和 launchdaemons）。
查看所有正在运行的计划任务
先确认哪些任务当前被 launchd 加载并处于活跃状态：
-
查当前用户级代理（登录后运行）：
launchctl list—— 显示所有已加载的用户服务，第三列是退出码（-表示仍在运行，0表示正常退出过） -
查系统级守护进程（无需登录）：
sudo launchctl list—— 列出 /Library/LaunchDaemons 和 /System/Library/LaunchDaemons 中已加载的服务 -
快速过滤某项（如备份任务）：
launchctl list | grep -i "backup"或sudo launchctl list | grep com.example.backup
定位任务配置文件位置
launchd 任务按权限和作用域分存于不同目录，对应不同生命周期：
-
用户级定时任务：配置文件在
~/Library/LaunchAgents/（仅当前用户登录时生效，可访问 GUI） -
系统级定时任务：配置文件在
/Library/LaunchDaemons/（开机即加载，合盖休眠后仍可唤醒执行） -
Apple 自带任务：位于
/System/Library/LaunchAgents/和/System/Library/LaunchDaemons/（受 SIP 保护，普通用户不可修改）
检查某项任务是否真正在运行
仅靠 list 不够可靠，需结合状态与上下文判断：
- 先查用户 UID：
id -u（通常为 501） - 再查具体服务实时状态：
launchctl print gui/501/com.example.job—— 输出中state = running才算真正运行中 - 若想看下次触发时间（适用于 StartCalendarInterval）：
launchctl print system/com.example.job | grep -A5 "Nextrun"（系统级）或替换system为gui/501（用户级）
启用、禁用或重载一个计划任务
注意区分“启用自启”和“立即启动”——这是最常混淆的操作：
-
启用开机/登录自动加载（不启动）：
launchctl enable gui/501/com.example.job（用户级）或sudo launchctl enable system/com.example.job（系统级） -
禁用自启（下次重启/登录不再加载）：
launchctl disable gui/501/com.example.job -
立即加载并运行（首次启用）：
launchctl load ~/Library/LaunchAgents/com.example.job.plist（用户级，无需 sudo） -
安全重载已修改的 plist：先卸载再加载，避免缓存残留：
launchctl bootout gui/501/com.example.job && launchctl load ~/Library/LaunchAgents/com.example.job.plist
查看任务日志与错误原因
大多数失败不报错，只静默退出。关键排查方式：
- 检查配置中是否设置了日志路径：
StandardOutPath和StandardErrorPath对应的文件（如/tmp/myjob.log） - 用 Console.app 搜索任务 Label 名称，筛选“system.log”或“user.log”中的相关条目
- 手动运行脚本路径验证权限与环境：
/bin/zsh -c '/path/to/script.sh'（模拟 launchd 启动环境） - 确认脚本有执行权限：
chmod +x /path/to/script.sh，且所有路径均为绝对路径
