macOS系统下git-maintenance功能运行日志存储位置查询

核心结论 #

默认配置下git-maintenance没有生成独立的持久化日志文件，你在.plist文件和Console应用中搜索不到相关内容是正常情况。

现有日志查询方法 #

如果是通过git maintenance start注册到launchd的定时任务，执行日志默认输出到系统日志缓存，可通过log命令行工具查询：

• 查询过去24小时的git-maintenance相关日志：
  log show --predicate 'process == "git" and contains(composedMessage, "maintenance")' --last 24h
  可将--last 24h替换为你需要的时间范围，比如--last 7d代表查询过去7天的日志。

配置持久化日志的两种方案 #

方案1：通过git原生配置（推荐，需git 2.37及以上版本） #

git原生支持配置maintenance日志存储路径，执行以下命令设置即可：
git config --global maintenance.logpath ~/Library/Logs/git-maintenance.log
设置完成后所有git-maintenance执行日志会自动写入你指定的路径。

方案2：修改launchd plist配置 #

如果你的git版本低于2.37，可以修改注册的launchd plist文件指定日志输出路径：

1. 打开plist文件：~/Library/LaunchAgents/org.git-scm.git.maintenance.plist
2. 新增以下配置项，替换为你实际的用户名和日志路径：

<key>StandardOutPath</key>
<string>/Users/[你的用户名]/Library/Logs/git-maintenance.out.log</string>
<key>StandardErrorPath</key>
<string>/Users/[你的用户名]/Library/Logs/git-maintenance.err.log</string>

3. 重新加载任务使配置生效：
   launchctl unload ~/Library/LaunchAgents/org.git-scm.git.maintenance.plist && launchctl load ~/Library/LaunchAgents/org.git-scm.git.maintenance.plist

临时验证执行状态 #

你也可以直接手动执行一次维护任务，直接在终端查看实时输出：
git maintenance run

内容的提问来源于stack exchange，提问作者Klas Mellbourn