本文介绍 GitHub Actions 中 download-artifact 插件的使用方法。涵盖基础下载、指定目录、合并多工件、模式匹配筛选及跨仓库下载等核心功能。详细解析配置参数如 name、path、pattern、merge-multiple 等。同时提供最佳实践，包括文件权限处理（建议使用 tar 打包）、版本兼容性注意事项（v4 不支持 GHES 及旧版上传）及性能优化建议。旨在帮助开发者高效管理 CI/CD 流程中的构建产物。
GitHub Actions 的 download-artifact 插件是 CI/CD 流程中管理构建产物的核心工具。本指南将详细介绍如何高效使用这个强大的下载工件功能，帮助您在自动化工作流中轻松获取所需的构建文件。
download-artifact 是 GitHub Actions 官方提供的下载插件，专门用于从工作流运行中下载之前上传的构建产物。无论是单个应用构建、多平台编译结果，还是测试报告文档，都能通过这个插件快速获取。
最简单的使用场景是下载特定名称的工件：
jobs:
build:
steps:
- uses: actions/download-artifact@v4
with:
name: my-artifact
您可以将工件下载到指定目录：
jobs:
build:
steps:
- uses: actions/download-artifact@v4
with:
name: my-artifact
path: your/destination/dir
如果省略 name 参数，将下载当前运行的所有工件：
jobs:
build:
steps:
- uses: actions/download-artifact@v4
在多平台构建场景中，您可能希望将所有工件合并到同一目录：
jobs:
build:
steps:
- uses: actions/download-artifact@v4
with:
path: path/to/artifacts
merge-multiple: true
通过 pattern 参数可以使用 glob 模式筛选要下载的工件：
jobs:
build:
steps:
- uses: actions/download-artifact@v4
with:
path: my-artifact
pattern: my-artifact-*
merge-multiple: true
download-artifact 支持从其他仓库或工作流运行下载工件：
jobs:
build:
steps:
- uses: actions/download-artifact@v4
with:
name: my-other-artifact
github-token: ${{ secrets.GH_PAT }}
repository: actions/toolkit
run-id: 1234
在复杂的 CI/CD 流程中，您可能需要在多个平台上构建应用：
jobs:
upload:
strategy:
matrix:
runs-on: [ubuntu-latest, macos-latest, windows-latest]
steps:
- name: 创建文件
run: echo "hello from ${{ matrix.runs-on }}" > file-${{ matrix.runs-on }}.txt
- name: 上传工件
uses: actions/upload-artifact@v4
with:
name: my-artifact-${{ matrix.runs-on }}
path: file-${{ matrix.runs-on }}.txt
download:
needs: upload
steps:
- name: 下载所有工件
uses: actions/download-artifact@v4
with:
path: my-artifact
pattern: my-artifact-*
merge-multiple: true
需要注意的是，工件上传过程中文件权限不会保留。所有目录权限为 755，文件权限为 644。如果需要保留权限，建议使用 tar 打包：
- name: 打包文件
run: tar -cvf my_files.tar /path/to/my/directory
- name: 上传工件
uses: actions/upload-artifact@v4
with:
name: my-artifact
path: my_files.tar
download-artifact v4 版本相比之前版本有显著性能提升，下载速度最高可提升 90%。为了获得最佳性能，建议：
pattern 参数减少不必要的下载如果下载失败，请检查：
download-artifact 插件是 GitHub Actions 生态系统中不可或缺的工具，通过本指南的学习，您已经掌握了从基础到高级的各种使用技巧。无论是简单的单文件下载，还是复杂的多平台构建产物管理，都能轻松应对。
记住核心要点：合理使用 pattern 和 merge-multiple 参数，正确处理跨仓库下载场景，以及注意文件权限的维护。现在就开始在您的 CI/CD 工作流中应用这些知识，享受高效的构建产物管理体验！
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online
通过删除不必要的空白来缩小和压缩JSON。 在线工具，JSON 压缩在线工具，online
将JSON字符串修饰为友好的可读格式。 在线工具，JSON美化和格式化在线工具，online