GitHub Actions中`uses: ./`语法的作用是什么?
GitHub Actions中
uses: ./的作用 uses: ./是用来引用当前仓库根目录下的本地自定义Action的语法,核心就是直接加载仓库内定义的Action,不用依赖外部仓库或官方市场的Action。
关键要点:
- 必须满足的前提:仓库根目录下存在
action.yml(或action.yaml)文件,这个文件是自定义Action的配置入口,里面要定义好Action的输入参数、输出结果、运行脚本/容器等核心逻辑。 - 路径规则:这里的
./是相对仓库根目录的路径,如果你的自定义Action在子目录里,比如.github/actions/deploy,就写uses: ./.github/actions/deploy,本质都是引用本地目录里的Action配置。
常用场景:
- 把仓库内通用的工作流逻辑(比如代码打包、镜像构建)封装成本地Action,在多个工作流文件里复用,避免重复写脚本。
- 在单仓库多工作流的场景中,统一管理自定义逻辑,修改时只需要改一处本地Action配置,所有用到它的工作流都会同步更新。
简单示例:
假设仓库根目录有action.yml,内容大概是:
name: '本地构建Action' runs: using: 'composite' steps: - run: npm install shell: bash - run: npm run build shell: bash
那在工作流里就可以直接这样用:
jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: ./
内容的提问来源于stack exchange,提问作者user1074593
相关产品推荐
相关产品推荐

