Mac 怎么用 launchd 定时自动运行脚本
用 launchd 和 plist 配置定时任务,讲清加载、排查语法错误、以及睡眠错过定时点该怎么处理。
想每天固定时间跑一个备份脚本、清理脚本或者抓数据的脚本,Mac 上最稳的官方做法是 launchd,而不是老式的 cron。它跟随系统启动,任务配置就是一个 plist 文件,写好后加载进去就行,不需要常驻进程。
入口在哪
- 用户级任务目录:个人文件夹下的资源库,再进 LaunchAgents。
- 系统级任务目录:根目录下的资源库,再进 LaunchDaemons,需要管理员权限。
- 管理入口:终端里的 launchctl,用来加载、查看状态和卸载任务。
- 选哪一层:要读个人文件夹的脚本放用户级目录,不需要登录会话的后台任务才放系统级目录。
具体步骤
- 先把脚本写好放在固定路径,第一行写清解释器路径,并给脚本加上执行权限。
- 在用户级 LaunchAgents 目录里新建一个 plist 文件,文件名建议和任务标识保持一致,比如 com.example.backup.plist。
- 填几个关键字段:Label 写唯一标识,ProgramArguments 用数组形式写脚本的绝对路径和参数,StartCalendarInterval 里写 Hour 和 Minute。
- 给 plist 配上标准输出和标准错误的日志文件路径,运行结果才有地方可查,不然出错时只能靠猜。
- 用
plutil -lint 文件路径检查语法,报错就按提示修,这一步能挡掉绝大多数不执行的情况。 - 加载任务:
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.example.backup.plist。 - 卸载任务:
launchctl bootout gui/$(id -u)/com.example.backup,标识与 Label 一致。
几个坑
- plist 少一个括号或标签就会静默失败,加载时不报错但任务永远不跑,先跑 plutil 再谈别的。
- ProgramArguments 里不能用波浪号,必须写完整绝对路径,脚本里调用的其他文件同理。
- 脚本要读桌面、文稿、外置盘时,得给执行它的程序授予完全磁盘访问权限,否则读到空目录还不报错。
- launchd 给的环境变量极少,PATH 只有系统默认几条。脚本里调用命令要么写绝对路径,要么自己在脚本开头设好 PATH。
- 睡眠期间错过的定时点不会全部补跑,一般只在唤醒后补一次,别把它当准点闹钟用。
- 同一个标识重复加载会提示已存在,改完 plist 要先卸载再加载,否则改的内容不生效,看起来像没保存。
怎么验证
先手动触发一次 launchctl kickstart -k gui/$(id -u)/com.example.backup,看脚本产出的文件有没有生成;再用 launchctl 的 print 子命令查看该任务,能看到上次退出码;等一个真实定时点过后,核对退出码是否为 0、日志文件里有没有新内容。
常见问题
和 cron 有什么区别
launchd 是现在系统推荐的机制,对睡眠唤醒、权限和日志的处理更完整。cron 仍然可用,但定时点跨睡眠时表现不如它稳。
手动跑正常,定时跑就失败
九成是环境和权限不同。在脚本里全部用绝对路径,把标准输出和标准错误重定向到日志文件,跑一次就能看出卡在哪一步。
能不能用它启动图形界面程序
不建议。定时任务适合无交互的命令行脚本,启动带界面的程序容易因为会话状态不对而失败,还可能反复弹窗。
一句话总结:plist 先过 plutil、路径全写绝对、加载用 bootstrap,日志和退出码才是判断依据。