在macOS中实现程序自启动等需正确编写launchd plist文件：用户级放~/Library/LaunchAgents/，系统级放/Library/LaunchDaemons/；必须符合XML规范并用plutil校验；脚本需设可执行权限；加载后用launchctl调试。
如果您需要在 macOS 系统中实现程序的自启动、定时执行或后台常驻运行，则必须正确编写符合 Apple 规范的 launchd 配置文件（.plist）。该文件是 XML 格式，结构严格，任何语法错误都将导致加载失败。以下是实际可操作的配置方法：
一、确认 plist 文件存放位置与作用域
launchd 的配置文件根据存放路径决定其运行权限与触发时机。用户级任务应置于 ~/Library/LaunchAgents/，仅在对应用户登录后生效；系统级守护进程须置于 /Library/LaunchDaemons/，需 root 权限且开机即载入。路径错误将直接导致 launchctl load 命令报错“Operation not permitted”或“No such file”。
1、打开终端，创建用户级配置目录（若不存在）：
mkdir -p ~/Library/LaunchAgents
2、确认当前用户对目标目录具有写入权限：
ls -ld ~/Library/LaunchAgents
3、检查系统级目录是否可写（仅限管理员）：
ls -ld /Library/LaunchDaemons
二、编写基础结构正确的 plist 文件
所有 launchd plist 必须以标准 XML 声明开头，并严格引用 Apple 官方 DTD。dict 容器内为实际配置项，外部结构不可修改。Label 值必须全局唯一，否则 launchctl 将拒绝加载并提示“Invalid argument”。
1、使用文本编辑器新建文件，例如：
vi ~/Library/LaunchAgents/com.example.hello.plist
2、输入以下最小可用模板（注意空格、引号、大小写及换行）：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.example.hello</string>
<key>ProgramArguments</key>
<array>
<string>/bin/echo</string>
<string>Hello from launchd</string>
</array>
<key>RunAtLoad</key>
<true/>
</dict>
</plist>
3、保存并退出编辑器。
三、验证 plist 语法有效性
在加载前必须验证 XML 结构合法性。Apple 提供 plutil 工具进行静态检查，不依赖 launchd 运行环境，可快速定位标签缺失、引号不闭合等低级错误。
1、执行校验命令：
plutil -lint ~/Library/LaunchAgents/com.example.hello.plist
2、若输出为“OK”，表示语法无误；若提示“Expected element name instead of …”，说明某处存在非法字符或未闭合标签。
3、如需查看格式化后的内容（辅助排查缩进问题）：
plutil -p ~/Library/LaunchAgents/com.example.hello.plist
四、设置脚本可执行权限并关联 ProgramArguments
当 plist 中使用 Program 或 ProgramArguments 调用外部脚本时，该脚本必须具备可执行权限（x），否则 launchd 启动时将返回“Permission denied”错误，且不会写入日志。Shell 脚本还需指定解释器路径，避免因 PATH 环境变量缺失而失败。
1、创建待执行脚本：
echo '#!/bin/sh\necho "$(date): launched" >> /tmp/launchd_test.log' > ~/scripts/test.sh
2、赋予可执行权限：
chmod 755 ~/scripts/test.sh
3、在 plist 的 ProgramArguments 中使用绝对路径：
<key>ProgramArguments</key>
<array>
<string>/bin/sh</string>
<string>/Users/$(whoami)/scripts/test.sh</string>
</array>
五、加载与调试配置文件
加载 plist 后，launchd 将按配置启动任务。若未生效，需检查是否已正确加载、是否触发条件满足、以及标准输出/错误路径是否存在可写权限。launchd 不继承用户 shell 环境变量，因此不能依赖 ~/.zshrc 中定义的别名或路径。
1、加载用户级配置：
launchctl load ~/Library/LaunchAgents/com.example.hello.plist
2、立即触发一次（仅适用于 RunAtLoad 或 StartCalendarInterval 已到时）：
launchctl start com.example.hello
3、查看运行状态与最近日志：
launchctl list | grep example
launchctl print gui/$(id -u)/com.example.hello 2>/dev/null | grep -E "(state|last exit)"
4、若需输出日志，确保 StandardOutPath 和 StandardErrorPath 指向可写目录，例如：
<key>StandardOutPath</key>
<string>/tmp/com.example.hello.out</string>
<key>StandardErrorPath</key>
<string>/tmp/com.example.hello.err</string>
