首页/开发/CI/CD 与发布速查/GitHub Actions 制品上传与下载
工具链要点63 条

GitHub Actions 制品上传与下载

用 upload-artifact 保存作业产物、download-artifact 在其他作业取用;v4 起同一工作流内制品名不可重复,制品有保留期。

CI/CD 与发布速查开发更新于 2026-10-12
上传actions/upload-artifact@v4(name、path、retention-days)
下载actions/download-artifact@v4
v4 语义制品不可变,同名上传会失败
保留期按仓库设置,到期删除

按矩阵命名

按矩阵命名
- uses: actions/upload-artifact@v4
  with:
    name: dist-${{ matrix.os }}
    path: dist/
制品名带上矩阵变量或作业名:v4 语义下重名直接失败。

易错点

  • 沿用 v3 同名上传习惯:迁移 v4 后流水线报错
  • 把制品当长期归档:保留期到期即删除,长期留存要用其他存储

数据来源与参考

  • GitHub Docs《Storing and sharing data from a workflow》
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌