如何便捷构建并发布支持多.NET Framework版本的NuGet包？

嘿，这个场景我太熟悉了——手动维护多框架版本的NuGet包确实挺折腾的，但有几个成熟的方法能帮你把整个流程自动化，省不少重复劳动。

1. 用MSBuild多目标框架（Multi-Targeting）统一构建 #

这是最基础也最推荐的方案，不用单独为每个.NET Framework版本建项目，直接在你的csproj文件里配置多目标框架即可：

打开项目的.csproj文件，修改TargetFrameworks节点（注意是复数形式，和单个框架的TargetFramework区分）：

<PropertyGroup>
  <!-- 替换成你需要支持的.NET Framework版本，比如net45、net462、net48 -->
  <TargetFrameworks>net45;net462;net48</TargetFrameworks>
  <!-- 统一设置版本号，也可以后续通过CI传递 -->
  <Version>1.2.3</Version>
</PropertyGroup>

配置完成后，运行dotnet build或者在Visual Studio里点击构建，MSBuild会自动为每个框架版本生成对应的输出文件（在bin/Release/{框架版本}目录下）。

之后直接运行dotnet pack命令，它会自动把所有框架的DLL打包到同一个NuGet包里，生成一个支持多框架的包文件，不用手动合并DLL。

2. 用GitHub Actions实现CI/CD自动发布 #

如果你的项目托管在GitHub上，完全可以把构建、打包、发布的流程全自动化，每次打版本标签就自动发布到NuGet：

在项目根目录创建.github/workflows/nuget-publish.yml文件，内容示例如下：

name: 自动发布NuGet包

on:
  push:
    tags:
      - 'v*' # 当推送v开头的版本标签（比如v1.2.3）时触发流程

jobs:
  build-and-publish:
    runs-on: windows-latest # .NET Framework的构建依赖Windows环境
    steps:
      - name: 拉取代码
        uses: actions/checkout@v4

      - name: 配置.NET环境
        uses: actions/setup-dotnet@v4
        with:
          dotnet-version: '8.x' # 根据你的项目需求选择合适的.NET SDK版本

      - name: 还原依赖
        run: dotnet restore

      - name: 构建项目
        run: dotnet build --configuration Release --no-restore

      - name: 生成NuGet包
        run: dotnet pack --configuration Release --no-build --output ./nupkgs
        # 如果需要从标签自动获取版本号，可以加参数：/p:Version=${{ github.ref_name }}

      - name: 发布到NuGet
        run: dotnet nuget push ./nupkgs/*.nupkg --api-key ${{ secrets.NUGET_API_KEY }} --source https://api.nuget.org/v3/index.json

配置注意事项： #

• 在GitHub仓库的「Settings → Secrets and variables → Actions」里添加NUGET_API_KEY，值为你的NuGet官方API密钥。
• 后续发布新版本时，只需要在本地打标签（比如git tag v1.2.4），然后推送到GitHub（git push origin v1.2.4），流程就会自动执行。

3. 用Nuspec文件手动指定多框架DLL（备选方案） #

如果因为某些原因无法修改csproj使用多目标框架，可以用NuSpec文件来手动指定各个框架的DLL路径：

创建一个YourLibrary.nuspec文件，示例内容：

<?xml version="1.0"?>
<package xmlns="http://schemas.microsoft.com/packaging/2013/05/nuspec.xsd">
  <metadata>
    <id>YourLibrary</id>
    <version>1.2.3</version>
    <authors>Your Name</authors>
    <description>支持多.NET Framework版本的类库</description>
  </metadata>
  <files>
    <file src="bin\Release\net45\YourLibrary.dll" target="lib\net45" />
    <file src="bin\Release\net462\YourLibrary.dll" target="lib\net462" />
    <file src="bin\Release\net48\YourLibrary.dll" target="lib\net48" />
    <!-- 别忘了添加pdb文件，方便调试 -->
    <file src="bin\Release\net45\YourLibrary.pdb" target="lib\net45" />
  </files>
</package>

然后运行nuget pack YourLibrary.nuspec命令生成NuGet包。不过这个方案需要手动维护文件路径，不如多目标框架灵活，只推荐在特殊场景下使用。

额外小技巧 #

• 统一版本管理：可以在csproj里设置<VersionPrefix>1.2</VersionPrefix>，然后用<VersionSuffix>beta1</VersionSuffix>来管理预发布版本，或者通过CI从标签自动获取版本号。
• 框架特定代码：如果不同框架需要不同的实现，可以用预编译指令，比如：

  #if NET45
  // .NET 4.5特有的代码
  #elif NET48
  // .NET 4.8特有的代码
  #endif
  

• 自动化测试：在GitHub Actions流程里添加测试步骤，针对每个框架版本运行单元测试，确保兼容性。

这些方案里，多目标框架+GitHub Actions的组合应该是最省心的，一次配置之后几乎不用手动干预版本发布，能帮你节省大量时间。

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