如何通过GitHub Actions仅向Azure App Service推送更新文件而非全量重新部署

完全可以实现仅同步更新文件到Azure App Service，无需每次全量构建部署，以下是可落地的具体方案：

方案1：使用Azure官方部署Action的增量配置 #

Azure官方提供的azure/webapps-deploy GitHub Action原生支持增量部署能力，无需自行改造底层逻辑：

• 先配合actions/cache缓存node_modules目录，只要package.json、package-lock.json没有变更，就跳过依赖安装步骤
• 部署时添加clean: false参数，部署工具会自动对比本地文件和Azure站点已有的文件，仅上传有变更的内容，不会覆盖未修改的文件
  示例工作流片段：

# 缓存node_modules避免重复安装
- name: 缓存Node依赖
  uses: actions/cache@v3
  id: node-cache
  with:
    path: node_modules
    key: ${{ runner.os }}-node-${{ hashFiles('**/package-lock.json') }}

- name: 安装依赖
  if: steps.node-cache.outputs.cache-hit != 'true'
  run: npm install

# 增量部署
- name: 部署到Azure App Service
  uses: azure/webapps-deploy@v2
  with:
    app-name: '你的应用名称'
    publish-profile: ${{ secrets.AZURE_WEBAPP_PUBLISH_PROFILE }}
    package: .
    clean: false

方案2：自行实现差异文件同步 #

如果你需要更灵活的控制同步逻辑，可以基于Git差异和Kudu接口实现：

• 首先缓存上一次成功部署的Commit SHA，可以存在GitHub仓库变量或者专门的缓存路径中
• 执行git diff --name-only <上一次部署SHA> <当前SHA>获取本次提交的变更文件列表，过滤掉不需要同步的文件（比如.git目录、.gitignore标记的忽略文件）
• 调用Azure App Service自带的Kudu VFS接口，单独上传变更文件，删除本次提交中移除的文件即可

注意事项 #

• 如果你的应用需要编译（比如TypeScript项目、前端框架项目），可以开启对应构建工具的增量编译能力，仅重新构建变更的模块，不用全量构建
• 如果本次提交修改了依赖配置文件，还是需要重新安装依赖并同步相关文件，避免运行时出现依赖缺失报错
• 首次使用增量部署前，建议先执行一次全量部署，保证GitHub和Azure两侧的基础文件完全一致，避免出现差异遗漏

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