在Mac上持续开发，特别是频繁使用GitHub Actions或本地克隆项目时，你的硬盘空间可能会被大量日志文件悄然占据。这些文件通常藏在/var/log/、~/Library/Logs/或GitHub CLI的缓存路径中，日积月累，足以让“系统数据”的占用率飙升。别担心，以下指南将帮你精准定位并安全清理这些与GitHub相关的日志“存量”。
一、清理GitHub CLI操作日志与缓存条目
当你通过GitHub CLI（即gh命令）执行actions、cache、run等操作时，除了完成任务，它还会在后台生成调试日志与缓存元数据。这些文件虽不直接影响CI运行，但长期堆积，占用几百MB空间是常事。
清理步骤很简单：首先，打开访达（Finder），按Command+Shift+G调出“前往文件夹”窗口。然后输入~/Library/Logs/gh并回车。如果该路径不存在，说明尚未产生相关CLI日志，可直接跳过。
若路径存在，进入后查看文件列表，重点寻找文件名中带有debug、cache-*字样，或修改日期超过30天的.log文件。选中它们，按Command+Delete移至废纸篓，最后清空废纸篓，空间即可释放。
二、清除GitHub Actions本地缓存（含workflow日志归档）
当使用gh run list查看工作流或通过本地runner调试时，GitHub CLI会将工作流输出缓存到~/.cache/gh/runs/及一些临时日志目录中。问题在于，这些缓存不会随工作流结束自动消失，里面常保存完整的stdout/stderr快照。
要处理它们，需打开“终端”应用。执行cd ~/.cache/gh/runs进入缓存目录。用ls -lt | head -20可快速列出最近20条运行记录，做到心中有数。
接着，可安全删除30天前的旧缓存，同时保留近几次记录以备查验。执行命令：find . -maxdepth 1 -type d -mtime +30 -name "run_*" -exec rm -rf {} +。完成后，再清理关联的日志目录：rm -rf ~/.cache/gh/logs/*.log。
三、删除系统级GitHub相关守护进程日志（/var/log/）
系统级/private/var/log/目录下也可能潜伏着“大文件”。例如git-remote-https、xcodebuild或GitHub Desktop后台服务写入的调试日志。尤其当你启用了Xcode CLI工具链后，system.log中常混入大量针对github.com域名的请求记录。
清理前需先确认。在终端输入：sudo ls -la /private/var/log/ | grep -i "github\|gh\|git"。如果返回结果中有类似github.log、gh-daemon.log或git-*.log这样命名的独立文件，即可用sudo rm -f命令删除。
这里有一个重要提醒：只删除那些明确带有GitHub标识的日志文件。千万不要执行rm -rf /private/var/log/*这类粗暴命令，以免误删system.log等核心系统日志，引发故障。
四、清空GitHub Desktop应用日志与诊断数据
如果你使用GitHub Desktop for Mac，其日志与诊断数据会保存在~/Library/Application Support/GitHub Desktop/logs/路径下。这些文件记录了UI操作、网络请求甚至崩溃信息，单个文件可达50–200MB。
清理步骤：同样按Command+Shift+G打开“前往文件夹”，输入上述路径回车。进入后按“修改日期”排序，选中所有创建时间早于15天的.log和.json文件（可按住Command键多选），右键“移到废纸篓”。
最后，启动GitHub Desktop，点击菜单栏“GitHub Desktop → Preferences → Advanced”，找到并点击“Clear cache and restart”按钮，完成应用内缓存清理并重启。
五、使用终端命令批量过滤并删除含GitHub关键词的归档日志
系统的日志轮转机制（如newsyslog）会将旧日志压缩归档，生成类似system.log.0.gz、system.log.1.old的文件。这些压缩包中也可能嵌入GitHub API调用、OAuth令牌调试等冗余信息，可通过关键词扫描精准剔除。
打开终端，切换到系统日志目录：cd /private/var/log。然后用grep查找所有包含“github”或“api.github.com”的归档文件：grep -l -i "github\|api\.github\.com" *.gz *.old 2>/dev/null。
命令会返回匹配的文件名列表。接着，只对这些列出的文件执行删除操作，例如：sudo rm -f system.log.0.gz kernel.log.2.old。再次强调，务必只删除grep命令实际输出的文件，绝对不要使用通配符盲目删除，这是保证操作安全的关键。
