如何根据操作系统类型排除指定.NET 5.0项目参与构建

优先方案：修改Windows应用项目配置（全场景兼容） #

该方案无需调整任何构建命令，天然兼容Visual Studio、JetBrains Rider、dotnet CLI三类构建场景，操作如下：
打开你的Windows Application项目对应的.csproj文件，调整首段属性组配置：

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <!-- 仅Windows系统下生效目标框架配置 -->
    <TargetFramework Condition="'$(OS)' == 'Windows_NT'">net5.0-windows</TargetFramework>
    <!-- 非Windows系统下标记项目为不可构建、不可打包、不可测试，自动跳过 -->
    <IsBuildable Condition="'$(OS)' != 'Windows_NT'">false</IsBuildable>
    <IsPackable Condition="'$(OS)' != 'Windows_NT'">false</IsPackable>
    <IsTestable Condition="'$(OS)' != 'Windows_NT'">false</IsTestable>

    <!-- 此处保留你项目原有的其他配置，例如UseWindowsForms、UseWPF、输出类型等 -->
    <OutputType>WinExe</OutputType>
    <UseWindowsForms>true</UseWindowsForms>
  </PropertyGroup>

  <!-- 项目原有其他引用、编译配置等全部保持不变 -->
</Project>

实现原理 #

• MSBuild 内置属性$(OS)在所有Windows系统下固定返回值为Windows_NT，Mac、Linux系统下返回值为Unix，可准确识别当前运行环境
• IsBuildable是MSBuild原生支持的属性，所有主流.NET IDE（VS、Rider）和dotnet命令行工具都会识别该标记，值为false时会直接跳过该项目的所有构建相关操作，不会抛出目标框架不兼容错误
• 额外添加的IsPackable、IsTestable配置可避免dotnet test、dotnet pack执行时对跳过项目做异常检查

备选方案：使用解决方案过滤器（适合CI/CD场景） #

如果不想修改项目文件，可单独维护过滤器文件，仅在非Windows系统下使用：

1. 在解决方案根目录创建后缀为.slnf的过滤器文件（例如NonWindowsBuild.slnf），内容如下：

{
  "solution": {
    "path": "替换为你的实际解决方案文件名.sln",
    "projects": [
      "src/公共类库/公共类库.csproj",
      "src/Web项目/Web项目.csproj",
      // 此处列出所有除Windows专属应用之外需要构建的项目相对路径
    ]
  }
}

2. 非Windows系统下执行命令时指定过滤器即可：

• dotnet build NonWindowsBuild.slnf
• dotnet test NonWindowsBuild.slnf
• dotnet pack NonWindowsBuild.slnf

该方案的缺点是需要手动维护过滤器内的项目列表，且直接打开完整解决方案时仍会出现项目加载报错，仅适合纯命令行的CI/CD场景使用。

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