actions/checkout · 中文介绍

actions/checkout

★ 9,017 · Forks 2,749

actions/checkout 是 GitHub Actions 的代码获取步骤,用于把仓库文件放入工作目录,供后续构建、测试等步骤使用。

用于检出仓库代码的 GitHub Actions 动作。

  • 适合使用 GitHub Actions 自动处理代码的开发者,基本流程是触发工作流 → 获取仓库代码 → 执行后续任务。
  • 入门时在工作流的 steps 中添加 uses: actions/checkout@v7,并按 README 建议设置 contents: read 读取权限。
  • 默认只获取触发工作流的一个提交,设置 fetch-depth: 0 可获取所有分支和标签的完整历史,ref 可指定分支、标签或提交。
  • 支持只获取指定文件或目录、下载 Git LFS 大文件、获取子模块,以及把多个仓库放到不同目录。
  • 获取其他私有仓库需要提供有访问权限的个人访问令牌,也可配置 SSH 密钥来获取仓库。
  • v7 默认阻止由 pull_request_target 或 workflow_run 触发的工作流获取派生仓库的拉取请求代码,启用例外前需评估 README 所述风险。

依据已读取的 README 资料编写;较长资料可能使用节选,未实际测试仓库功能。
资料来源:README · 内容生成时间:2026-11-13T12:37:05+00:00

Kai 的头像

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注