GitHub Actions 怎么管理构建过程中的临时文件

舞夢輝影

舞夢輝影

2026-07-28

1028人浏览

原创

github actions 临时文件管理核心是机制协同而非手动删除:runner 每次 job 启动前自动清理 _tempdirectory,但 /tmp、工作目录根等需显式处理,ai 工具依赖的文件须通过 upload-artifact 显式持久化。

github actions 怎么管理构建过程中的临时文件

GitHub Actions 管理构建过程中的临时文件,核心不是“手动删”,而是靠机制协同 + 明确归属 + 适时释放。临时文件一旦失控,轻则磁盘告警、job 失败,重则污染后续构建、误导 AI 编程工具判断。

临时文件的默认清理行为

Runner 在每次 job 启动前,会自动清空自己的临时目录(_tempDirectory),这是硬编码在 Runner.Worker/TempDirectoryManager.cs 中的逻辑:

  • 清理范围:仅限 _tempDirectory 下内容(非整个 /home/runner/work
  • 方式:IOUtil.DeleteDirectory(..., contentsOnly: true)
  • 触发时机:job 执行前,不依赖你写任何命令

这意味着:

  • 你在 run: 步骤里用 mktempecho > /tmp/foo.txt 生成的文件,不会被自动清理(因为不在 _tempDirectory
  • 但所有 actions/checkoutactions/setup-node 等官方 action 创建的中间产物,基本都走这个 temp 路径,会被安全回收

显式控制临时文件生命周期

别等它“可能被清”,主动声明归属:

Git
Git

程序猿必备版本控制工具

下载
  • actions/upload-artifact 上传的文件,属于 workflow 级产物,不随 job 结束消失,但默认只存 90 天
  • actions/cache 缓存的依赖(如 node_modules),按 key 命中复用,不自动清理旧缓存,需靠 actions/cache@v4cache-hit 输出或定时 workflow 主动 purge
  • rm -rffind ... -mmin +60 -delete 手动清理,适合清理 /tmp 或自定义 build 目录(如 dist/, build/),建议放在 finally 类型的 step 里(配合 if: always()

避免临时文件“隐形堆积”

常见陷阱:

  • run: 里执行 docker build 却没加 --no-cache 或没清理 dangling image,镜像层持续占用 /var/lib/docker
  • 使用 pip install --user 把包装进 /home/runner/.local,下次 job 仍可见,且不触发 cache key 变更
  • 把生成文件写到工作目录根(如 ./output.zip),既没上传也没删,下次 actions/checkout 不会覆盖,越积越多

稳妥做法:

  • 所有构建产出统一放 ./dist./artifacts,job 结尾用 rm -rf ./dist(除非你要 upload)
  • Docker 构建后加一步 docker system prune -f --filter "until=24h"
  • Python 项目结尾加 pip list --user --format=freeze | grep -v "pkg-resources" | xargs pip uninstall -y(慎用,仅当确认无共享依赖时)

和 AI 编程工具协同的关键提醒

AI 工具(如 Cursor、Claude Code)常需读取上一轮的 coverage.json、sourcemap 或 dist 文件做比对。这些不能靠“临时文件”存活

  • 它们必须通过 upload-artifact 显式上传,并带上 commit SHA 或 PR number 作为 artifact name
  • 下游 job 用 download-artifact 指定 commit: ${{ github.event.pull_request.head.sha }} 精准获取,而非默认下载 latest
  • 别把它们混在 /tmp./ 下——AI 工具调用时找不到,就直接报“baseline missing”

不复杂但容易忽略。

相关专题

更多
Docker容器化部署与DevOps实践
Docker容器化部署与DevOps实践

本专题面向后端与运维开发者,系统讲解 Docker 容器化技术在实际项目中的应用。内容涵盖 Docker 镜像构建、容器运行机制、Docker Compose 多服务编排,以及在 DevOps 流程中的持续集成与持续部署实践。通过真实场景演示,帮助开发者实现应用的快速部署、环境一致性与运维自动化。

2026.02.11

138

16

PHP 命令行脚本与自动化任务开发
PHP 命令行脚本与自动化任务开发

本专题系统讲解 PHP 在命令行环境(CLI)下的开发与应用,内容涵盖 PHP CLI 基础、参数解析、文件与目录操作、日志输出、异常处理,以及与 Linux 定时任务(Cron)的结合使用。通过实战示例,帮助开发者掌握使用 PHP 构建 自动化脚本、批处理工具与后台任务程序 的能力。

2025.12.13

300

14

Figma AI自动化智能数据填充与交互生成实战
Figma AI自动化智能数据填充与交互生成实战

告别机械重复,详细演示如何用 AI 填充业务真实数据,并自动为页面添加交互连线,将静态设计稿快速转变为动态原型。

2026.05.13

142

17

墨刀AI提示词教学
墨刀AI提示词教学

本合集由PHP中文网精心整理,为您提供全面的墨刀AI提示词教学。内容涵盖高质量原型撰写公式与实操窍门,助您轻松掌握AI设计工具。无论是零基础入门还是进阶技巧,都能让您快速上手,大幅提升产品设计与协作效率。

2026.08.04

8

21

墨刀AI完整入门
墨刀AI完整入门

PHP中文网为您倾力打造墨刀AI保姆级入门指南完整版!本合集从零基础讲起,涵盖AI生成原型、提示词优化、图片转原型及多轮对话等核心功能。无论您是新手还是进阶用户,都能轻松掌握产品设计全流程。快来PHP中文网,一键解锁高效设计技巧,让想法即刻成型!

2026.08.04

5

20

墨刀AI进阶技巧
墨刀AI进阶技巧

本合集由PHP中文网精心整理,为您提供墨刀AI核心进阶策略指南。内容涵盖高效提示词写作、原型智能生成与微调、结构化导图制作及行业分析报告输出等实战技巧。助您轻松掌握AI设计工具,大幅提升产品设计与团队协作效率。

2026.08.04

7

14

火山引擎实名认证失败怎么办
火山引擎实名认证失败怎么办

火山引擎实名认证失败可能与证件信息填写错误、姓名或企业信息不一致、证件照片不清晰、营业执照状态异常、手机号验证失败或审核资料不完整有关。本专题整理个人认证、企业认证、资料上传、审核退回、重新提交和认证不通过的常见处理方法。

2026.08.04

4

10

火山引擎域名备案流程详解
火山引擎域名备案流程详解

火山引擎域名备案适合需要在火山引擎云服务器、对象存储、CDN或网站服务上绑定域名的用户参考。本专题整理备案入口、账号实名认证、备案类型选择、主体信息填写、网站信息提交、资料上传、初审核验、管局审核和备案失败排查,帮助用户完成网站上线前的备案流程。

2026.08.04

0

10

火山引擎DNS解析配置步骤
火山引擎DNS解析配置步骤

使用火山引擎DNS解析网站域名时,需要确认域名已完成管理接入,并正确配置服务器IP、CNAME地址或验证记录。本专题整理域名添加、记录类型选择、TTL设置、解析状态检查、备案和访问测试等流程,适合新手搭建网站时参考。

2026.08.04

2

10

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
vscode手册
vscode手册

共0课时 | 0人学习

Git 教程
Git 教程

共21课时 | 7.4万人学习

Git版本控制工具
Git版本控制工具

共8课时 | 1.7万人学习