使用GitHub Actions为.NET应用填充环境专属变量的相关问题咨询

GitHub Actions完全可以实现部署时动态替换web.config中的占位符，和Azure DevOps的变量替换功能逻辑一致，不需要为每个环境单独维护配置文件，以下是可直接落地的实现方案：

方案1：使用令牌替换Action（最简便） #

目前有长期维护的通用令牌替换Action，可直接适配你%变量名%格式的占位符，无需修改现有web.config配置：

• 先将所有需要填充的敏感配置值存入对应环境的GitHub Secrets中，变量名和占位符内的名称保持一致，例如命名为APP_CONFIG_URL
• 在工作流的.NET构建完成、部署到Azure之前，加入替换配置的步骤，示例配置如下：

- uses: cschleiden/replace-tokens@v1
  with:
    files: '**/Web.config'
    tokenPrefix: '%'
    tokenSuffix: '%'
  env:
    APP_CONFIG_URL: ${{ secrets.APP_CONFIG_URL }}
    # 其余需要替换的变量统一在此声明，左侧和占位符名称一致，右侧读取对应secrets即可

方案2：用系统内置命令实现（无第三方依赖） #

如果不想引入第三方Action，可根据运行器的系统环境用原生命令完成替换：

• Linux/macOS运行器使用sed命令：

- run: sed -i 's/%APP_CONFIG_URL%/${{ secrets.APP_CONFIG_URL }}/g' 你的Web.config实际路径

• Windows运行器使用PowerShell命令：

- run: (Get-Content 你的Web.config实际路径) -replace '%APP_CONFIG_URL%', '${{ secrets.APP_CONFIG_URL }}' | Set-Content 你的Web.config实际路径

补充方案：利用Azure App Service运行时覆盖特性 #

如果你的配置仅用于Azure Web Service，也可以直接在Azure门户对应Web App的「配置」-「应用程序设置」中添加APP_CONFIG_URL等配置项，Azure运行时会自动覆盖Web.config中appSettings节点的同名配置，无需在CI/CD流程中做任何修改，适合配置项较少、偏好在Azure端统一管理配置的场景。

多环境配置方案选择建议 #

除非不同环境的配置项差异极大、占位符数量多到维护成本很高，否则优先使用动态替换方案：

• 无需维护多份高度重复的配置文件，避免漏改通用配置的问题
• 敏感配置全部存储在GitHub Secrets中，不会明文提交到代码库，符合安全规范
• 后续新增配置项只需添加对应占位符和Secrets，改动成本极低

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