如何在GitHub README中动态使用当前分支名生成Azure部署链接（无需GitHub Actions）

由于GitHub没有提供可直接在仓库README中全局访问的当前分支环境变量（普通README不支持解析动态变量，仅GitHub Pages页面支持有限的Liquid模板），以下是几个无需GitHub Actions的可行方案：

方案1：本地脚本自动生成带分支名的README #

这是最直接满足需求的方法，通过本地脚本动态替换分支名后提交README：

• 先创建一个README模板文件（比如README.template.md），将链接中的分支名替换为占位符：

  [部署到Azure](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Forg%2Frepo-name%2FBRANCH_PLACEHOLDER%2Fazure%2Ftemplate.json)
  

• 编写一个简单的Bash脚本，获取当前分支名并替换占位符：

  # 获取当前分支名
  CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)
  # 替换模板中的占位符，生成最终README
  sed "s/BRANCH_PLACEHOLDER/$CURRENT_BRANCH/g" README.template.md > README.md
  

• 每次切换分支后，运行脚本更新README，再将更新后的README提交到当前分支即可。

方案2：利用GitHub Pages的Liquid模板（仅适用于Pages部署分支） #

如果你的仓库启用了GitHub Pages，可以通过Liquid变量动态获取分支名：

• 将README内容迁移到GitHub Pages的页面文件（比如index.md），修改链接为：

  [部署到Azure](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Forg%2Frepo-name%2F{{ site.github.ref | remove: 'refs/heads/' }}%2Fazure%2Ftemplate.json)
  

• 变量{{ site.github.ref }}会返回当前分支的完整引用（如refs/heads/develop），通过remove过滤器可以提取纯分支名。
• 注意：GitHub Pages默认仅从指定分支部署，若要查看其他分支的Pages内容，需要额外配置或使用分支预览工具。

方案3：使用HEAD别名（仅指向默认分支） #

如果仅需要链接指向仓库的默认分支，可以用HEAD代替硬编码的分支名：

[部署到Azure](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Forg%2Frepo-name%2FHEAD%2Fazure%2Ftemplate.json)

此方法无需任何预处理，但无法匹配当前查看的非默认分支。

内容的提问来源于stack exchange，提问作者Or Peleg