GitHub Actions Marketplace 的 action 能直接用本地路径吗？

诸葛诗雅提问于 2026-03-25 18:03:21 阅读 68

工具

我在写一个 GitHub Actions workflow，看到 Marketplace 上很多 action 都是用 uses: owner/repo@v1 这种方式引用的。但我现在想先在本地测试自己写的 action，能不能直接指向项目里的某个目录？比如 ./.github/actions/my-action 这样？

试过这样写但 CI 报错说找不到 action，是不是必须得推到仓库才能用？

代码管理工具使用版本控制

我来解答赞 9 收藏

反馈

1 条解答

Mc.翌萱 Lv1

在本地测试 GitHub Actions 的确有点麻烦，不过你的想法是对的，确实可以直接使用本地路径。问题可能出在你的工作流配置上。

首先确认你在 .github/workflows 里的 yaml 文件写法正确。要用本地 action 可以这样写：

jobs:

  build:

    runs-on: ubuntu-latest

    steps:

      - name: Checkout code

        uses: actions/checkout@v2



      - name: Run local action

        uses: ./.github/actions/my-action

注意几点：
1. checkout 步骤必须有，不然 CI 环境拿不到你的代码
2. 路径要从仓库根目录算起，别搞错了
3. 本地调试时记得 push 到一个分支，用 pull request 来触发 workflow

要是还是报错，检查下权限设置和文件结构。有时候文件夹命名不对也会导致找不到 action。我在做后端集成的时候也遇到过类似问题，真是浪费了不少时间找 bug。

数据库层面倒是不用太担心，主要是文件系统和 workflow 配置的问题。多试几次应该能搞定。

2026-03-25 20:08