使用自仓库语法引用同仓库的 Actions

你现在可以使用新的自仓库语法，引用位于同一仓库中的操作或可重用工作流。

以 $/ 开头的 uses: 值会解析为你工作流自身仓库正在运行的确切提交，且无需 checkout。

它适用于所有工作区相对 ./ 语法可用的地方，包括工作流步骤、复合操作步骤、嵌套组合和可重用工作流调用。

在此之前，引用自己仓库中定义的操作，要么依赖 ./ 和 checkout，要么硬编码版本。

这是一种维护负担，并悄悄破坏了提交 SHA 固定。

使用自仓库引用，同级操作和工作流会自动匹配你正在运行的引用，因此即使调用者固定到完整长度的提交 SHA，你的内部引用也能保持一致。

这也使得采用企业策略成为可能，该策略要求对调用自身操作的工作流，将操作固定到完整长度的提交 SHA。

自仓库引用现在是组合仓库内操作和可重用工作流的推荐方式。

它们在 github.com 上可用。

此功能要求 GitHub Actions runner 版本为 2.336.0 或更高。

可通过查看关于查找和自定义操作的文档了解更多，或加入 GitHub Community 中的讨论。

GitHub Actions 新增自仓库引用语法，以 $/ 开头指向当前运行提交，无需 checkout，简化内部组合，并支持完整 SHA 锁定。

• GitHub Actions 新增自仓库引用语法，以 $/ 开头指向当前运行提交，无需 checkout，简化内部组合，并支持完整 SHA 锁定。
• 原贴提到：You can now reference an action or reusable workflow that lives in the s
• 来源：github.blog

这是什么信号：GitHub Actions 正式引入自仓库引用语法（$/），允许在同一仓库内使用相对于当前运行提交的引用方式调用操作或可重用工作流。这是对传统 ./ 路径和硬编码版本引用的一次重要升级，直接解决了内部组合的维护一致性问题。

为什么重要：此前，仓库内部引用操作或工作流时，要么使用 ./ 路径配合 checkout（需要额外步骤且不精确锁定），要么硬编码版本号（导致 SHA 锁定失效）。自仓库引用让内部引用自动跟随当前运行提交，即使外部调用方使用完整 SHA 锁定，内部引用也能保持同步，从而支持企业级安全策略——要求所有 actions 固定到完整 SHA。这降低了供应链风险，提升了可追溯性。

对谁有价值：对使用 GitHub Actions 维护复杂流水线的开发团队、DevOps 工程师以及有严格安全合规要求的企业最有价值。尤其是那些在仓库内组织大量可复用操作和复合工作流的项目，可以显著减少维护成本。

可以怎么行动：升级 GitHub Actions runner 到 2.336.0 或更高版本，然后在工作流中将原本使用 ./ 或硬编码版本引用同仓库操作的地方，改用 $/ 语法。例如，将 uses: ./.github/actions/my-action 改为 uses: $/.github/actions/my-action，并确保所有内部调用都遵循此模式。同时，为需要满足企业策略的仓库配置完整 SHA 固定审查。

风险或限制：该功能仅在 github.com 上可用，GitHub Enterprise Server 用户无法使用（除非未来支持）。另外，如果 runner 版本过低，功能将不可用，可能导致工作流失败。迁移到 $/ 语法后，旧版本 runner 的兼容性会被破坏，因此需要确保所有运行环境已升级。此外，对于外部引用的 actions，仍需使用传统方式，自仓库引用不适用于跨仓库场景。

这条内容的真正价值，不只是“有人发布了一个新功能”，而是它揭示了 github.blog 背后的产品方向、工作流变化或竞争信号。对 OPC 来说，这种信息可以转化成持续追踪的栏目选题。

如果把《使用自仓库语法引用同仓库的 Actions》放到你的内容系统里，它最大的价值在于帮助读者更快看懂“为什么值得关注”，而不是只看到一条碎片化动态。

• Allison 原帖