Visual Studio 2019 .NET Web应用构建排除Angular子文件夹仍报node_modules错误怎么办

问题根因 #

你当前配置不生效的核心原因是：配置的移除规则是在MSBuild已经扫描完全局文件、将文件加入构建队列后才执行，而部分MSBuild内置目标（比如静态资源合法性校验、TypeScript预编译等）会在移除规则执行前就处理AngularApp\node_modules下的文件，所以仍然会触发报错。

解决方案 #

按以下步骤修改配置即可完全排除AngularApp文件夹的非必要构建扫描：

1. 新增全局排除规则 #

在.csproj文件的顶层<PropertyGroup>节点（就是存放目标框架、项目名称等基础配置的节点）中添加全局排除配置，从扫描源头上拦截AngularApp目录：

<PropertyGroup>
  <!-- 保留原有配置，例如<TargetFramework>net6.0</TargetFramework>等，新增以下两行 -->
  <DefaultItemExcludes>$(DefaultItemExcludes);AngularApp\**;AngularApp\node_modules\**</DefaultItemExcludes>
  <!-- 如果你使用的是.NET Framework版本的ASP.NET项目，额外加下面这行 -->
  <EnableDefaultContentItems>false</EnableDefaultContentItems>
</PropertyGroup>

2. 简化原有ItemGroup配置 #

因为已经从扫描层面排除了整个AngularApp目录，不需要再单独移除各类文件，直接按需引入编译好的Angular产物即可：

<ItemGroup>
  <!-- 引入Angular编译产物 -->
  <Content Include="AngularApp\dist\prod\**\*">
    <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
  </Content>
  <!-- 原有配置项 -->
  <Content Update="appsettings.json;web.config">
    <CopyToPublishDirectory>PreserveNewest</CopyToPublishDirectory>
  </Content>
</ItemGroup>

3. 补充TypeScript排除规则（可选） #

如果你的ASP.NET项目开启了全局TypeScript编译，需要在项目根目录的tsconfig.json中添加AngularApp的排除规则，避免TS编译器扫描Angular项目的源码：

{
  // 保留原有compilerOptions等配置，修改exclude节点
  "exclude": [
    "bin",
    "obj",
    "AngularApp"
  ]
}

4. 清理缓存验证 #

修改完成后删除项目根目录的bin、obj文件夹，再重新执行构建，即可避免node_modules相关报错。

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