Azure DevOps CI/CD：更新文件正常但新增文件未部署至wwwroot问题咨询

这问题我之前帮人排查过好几次，核心大概率是Azure DevOps的构建/发布流程里，新增文件没被正确纳入到部署包里——而现有文件因为本来就在打包规则的覆盖范围内，更新后自然能正常同步到Web应用。下面给你拆解可能的原因和一步步的排查方向：

1. 先检查本地项目的文件属性与配置 #

这是最常见的根源，先从本地项目入手：

• 右键你的新增HTML文件，查看属性：确认「复制到输出目录」是不是设为了「始终复制」或「如果较新则复制」。如果是「不复制」，构建过程根本不会把它打包到输出文件夹里，自然部署不到Azure的wwwroot。
• 打开你的项目文件（比如YourWebProject.csproj），搜索新增文件的路径，看有没有类似 <Content Include="wwwroot\NewPage.html" /> 的条目。如果没有，说明Visual Studio没自动把这个文件标记为需要打包的内容文件，你可以手动添加这行配置保存后再测试。

2. 检查Azure DevOps构建管道的打包/复制规则 #

如果本地发布能看到新增文件，那问题就出在DevOps的构建流程里：

• 打开你的Azure DevOps构建管道，找到「复制文件」或「DotNet Publish」这类核心任务：
  • 如果用了Copy Files任务，检查它的「源文件夹」「目标文件夹」路径，以及「包含」规则是不是只写了特定文件（比如写死了现有HTML文件名列表，那新增的就会被漏掉）。
  • 如果用了DotNet Publish命令，看看有没有加额外的过滤参数，比如--exclude之类的，不小心排除了新增文件的路径。
• 去构建日志里找对应任务的输出，搜索新增文件的文件名，看日志里有没有提到它被跳过或者未被包含的记录——日志是排查这类问题的关键。

3. 验证Azure DevOps发布管道的部署设置 #

虽然概率低，但也可以排除发布环节的问题：

• 查看「Azure App Service Deploy」任务的配置，确认「包或文件夹」的路径是指向构建生成的完整输出包（比如$(Build.ArtifactStagingDirectory)/**），没有限制只部署特定子文件夹。
• 检查部署模式：如果用了「增量部署」，理论上新增文件会被自动同步，但你可以临时改成「完整部署」测试一次，看新增文件会不会出现（注意完整部署会覆盖目标所有文件，操作前确认没问题）。

4. 本地预发布验证 #

最快缩小范围的方法：在Visual Studio里用「发布」功能，把项目发布到本地的一个文件夹，然后查看这个文件夹的wwwroot目录里有没有新增的HTML文件。

• 如果本地发布后也没有，那问题完全在本地项目配置，和Azure DevOps无关；
• 如果本地有，那肯定是DevOps的构建/发布流程哪里没配置对，回到第二步仔细查日志。

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