macOS 开机自启：应用包自带与 launchd 手动配置

路线一：官方应用包（无需配置）

通过官方 macOS 应用包安装的用户什么都不用做：应用本身就是常规 Mac 应用，登录启动项在系统设置里按普通应用管理即可。这也是官方下载页把 macOS 应用包列为新用户起点的原因。

路线二：homebrew 安装

brew install syncthing

安装完成时 brew 会输出用 launchctl 注册服务的提示，照着执行即可注册为随登录自启的服务。之后的管理：

brew services start syncthing     # 启动并注册
brew services info syncthing      # 查看状态

路线三：手动 launchd（基础包用户）

从发布包解压安装的用户，官方文档给的步骤：

1. 把 syncthing 可执行文件放进主目录的 bin 文件夹（没有就建一个）；
2. 找到发布包里 etc/macos-launchd/syncthing.plist，把其中四处 USERNAME 替换为你的用户名；
3. 把 plist 复制到 ~/Library/LaunchAgents/（Finder 里「前往文件夹」输入该路径）；
4. 注销重登，或执行：

launchctl load ~/Library/LaunchAgents/syncthing.plist

登录后别弹浏览器

自启动场景下每次登录都自动开一个浏览器标签会很烦。在管理界面 Settings → General 里关掉 Start Browser 选项；此后要管理界面就手动访问 127.0.0.1:8384。

验证与排障

• 终端跑 syncthing --paths 确认配置目录位置（macOS 默认在 ~/Library/Application Support/Syncthing）；
• launchd 没生效时检查 plist 里的路径替换是否全部完成——四处 USERNAME 漏一处是最高频错误；
• 服务方式下日志同样可以从 GUI 的 Help → About → Paths 找到。

macOS 的文件系统大小写不敏感，与 Linux 设备混用时留意[大小写冲突(../06-版本与冲突/04-conflicts.md)。