如何在csproj中配置条件引用：开发用项目引用，GitHub Actions用NuGet？

完全可以通过MSBuild的条件属性在csproj文件中实现这种环境切换，核心思路是根据当前运行环境（本地开发/GitHub Actions）来决定加载项目引用还是NuGet包引用。

具体配置方法 #

GitHub Actions会自动设置GITHUB_ACTIONS环境变量为true，我们可以直接用这个变量作为判断条件。结合你的项目依赖场景，配置示例如下：

1. MyApp.Infrastructure.csproj 配置

<!-- 本地开发环境：使用项目引用，提升开发效率 -->
<ItemGroup Condition="'$(GITHUB_ACTIONS)' != 'true'">
  <ProjectReference Include="..\MyApp.Core\MyApp.Core.csproj" />
</ItemGroup>

<!-- GitHub Actions CI环境：使用NuGet包引用，保证包依赖的标准化 -->
<ItemGroup Condition="'$(GITHUB_ACTIONS)' == 'true'">
  <PackageReference Include="MyApp.Core" Version="1.0.*" />
</ItemGroup>

2. MyApp.Business.csproj 配置

<!-- 本地开发环境：同时引用两个依赖项目 -->
<ItemGroup Condition="'$(GITHUB_ACTIONS)' != 'true'">
  <ProjectReference Include="..\MyApp.Core\MyApp.Core.csproj" />
  <ProjectReference Include="..\MyApp.Infrastructure\MyApp.Infrastructure.csproj" />
</ItemGroup>

<!-- GitHub Actions CI环境：引用对应的NuGet包 -->
<ItemGroup Condition="'$(GITHUB_ACTIONS)' == 'true'">
  <PackageReference Include="MyApp.Core" Version="1.0.*" />
  <PackageReference Include="MyApp.Infrastructure" Version="1.0.*" />
</ItemGroup>

关键细节说明 #

• 版本号处理：示例中用1.0.*匹配同主版本的最新NuGet包，你也可以在CI流程中动态传递版本号（比如通过GitHub Actions的变量绑定版本），确保依赖包版本的一致性。
• 本地路径匹配：本地开发时要保证项目的相对路径和ProjectReference中的Include路径一致，这样解决方案才能正确加载依赖项目。
• 自定义条件可选：如果不想依赖GitHub的内置环境变量，也可以自定义MSBuild属性，比如IsLocalDev，本地构建时通过命令行指定dotnet build /p:IsLocalDev=true，然后把csproj中的条件改成'$(IsLocalDev)' == 'true'即可。

验证流程 #

1. 本地开发时，打开解决方案，所有依赖会自动以项目引用加载，修改代码后即时生效，无需手动打包NuGet。
2. 提交代码到GitHub仓库后，GitHub Actions会触发CI流程，此时会自动切换为NuGet包引用，正常生成符合要求的NuGet包。

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