如何在Visual Studio Code（C#/.NET）中排除文件/文件夹参与构建编译

.NET Core 项目的构建流程由 .NET SDK 统一管控，和你使用 Visual Studio 还是 VS Code 作为编辑器没有关系。VS Code 本身不提供独立的构建排除规则，所有配置直接在项目文件中完成即可，配置结果对 VS Code 的 C# 语言服务（智能提示、错误检测）和命令行执行dotnet build的构建流程都生效。

具体配置方式 #

打开项目根目录下的.csproj项目文件，在顶层<Project>节点下添加对应配置项即可：

• 排除单个指定文件
  路径为相对于.csproj文件所在目录的相对路径：

  <ItemGroup>
    <Compile Remove="LocalTest/TempDebug.cs" />
  </ItemGroup>
  

• 排除整个文件夹
  使用通配符递归匹配文件夹下所有C#代码文件，其中**代表匹配任意层级子目录，*代表匹配任意文件名：

  <ItemGroup>
    <Compile Remove="Deprecated/OldImpl/**/*.cs" />
  </ItemGroup>
  

• 按构建条件动态排除
  如果需要仅在特定构建配置/环境下排除文件，可给节点添加条件判断：

  <!-- 仅在Release发布构建时排除调试用辅助代码 -->
  <ItemGroup Condition="'$(Configuration)' == 'Release'">
    <Compile Remove="DebugUtils/**/*.cs" />
  </ItemGroup>
  

如果需要同时排除非代码文件的自动打包、复制到输出目录逻辑，可在同一个ItemGroup下追加对应配置：

<Content Remove="ExcludedFolder/**/*" />
<None Remove="ExcludedFolder/**/*" />

常见误区与验证方式 #

• 不要尝试通过修改VS Code的files.exclude、search.exclude配置实现构建排除：这两个配置仅控制编辑器侧边栏的文件显示、全局搜索的匹配范围，完全不会影响实际编译流程。
• 配置完成后，按Ctrl+Shift+P（macOS为Cmd+Shift+P）调出命令面板，执行.NET: Restart Language Server重启C#语言服务，即可让代码分析同步排除对应文件；在终端执行dotnet build查看构建输出，确认被排除文件未参与编译即可。

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