如何将C#项目的指定.NET5版本NuGet包及依赖还原至单一文件夹

1. 仅还原.NET5依赖包 #

首先执行dotnet restore并指定目标框架为.NET5，避免下载其他框架版本的包：

dotnet restore --framework net5.0

该命令会将项目所有依赖的NuGet包下载到本地NuGet缓存目录（Windows默认C:\Users\<用户名>\.nuget\packages，Linux/macOS默认~/.nuget/packages），但包文件仍分散在各自独立的文件夹中。

2. 提取.NET5 DLL到统一文件夹 #

方式一：脚本批量复制 #

Windows PowerShell脚本

假设目标文件夹为./nuget-dlls，创建并执行以下脚本：

$targetDir = "./nuget-dlls"
New-Item -ItemType Directory -Force -Path $targetDir

# 从项目.lock.json文件读取依赖包信息
$lockFile = Get-Content "./<你的项目文件名>.csproj.lock.json" | ConvertFrom-Json
$packages = $lockFile.packages.PSObject.Properties | ForEach-Object {
    return @{ Name = $_.Name; Version = $_.Value.version }
}

# 遍历包目录，复制net5.0下的DLL
foreach ($pkg in $packages) {
    $pkgLibPath = "$env:USERPROFILE\.nuget\packages\$($pkg.Name)\$($pkg.Version)\lib\net5.0"
    if (Test-Path $pkgLibPath) {
        Copy-Item "$pkgLibPath\*.dll" -Destination $targetDir -Force
    }
}

Linux/macOS Shell脚本

#!/bin/bash
targetDir="./nuget-dlls"
mkdir -p "$targetDir"

# 借助jq从.lock.json提取包名和版本（需提前安装jq）
packages=$(jq -r '.packages | to_entries[] | "\(.key)|\(.value.version)"' ./<你的项目文件名>.csproj.lock.json)

while IFS='|' read -r name version; do
    pkgLibPath="$HOME/.nuget/packages/$name/$version/lib/net5.0"
    if [ -d "$pkgLibPath" ]; then
        cp "$pkgLibPath"/*.dll "$targetDir/"
    fi
done <<< "$packages"

注意：替换脚本中的<你的项目文件名>为实际项目名称，确保dotnet restore已生成对应的.lock.json文件。

方式二：自定义MSBuild目标 #

无需编写脚本，直接在项目的.csproj文件中添加以下自定义目标：

<Target Name="CopyNuGetDllsToSingleFolder" AfterTargets="Restore">
  <ItemGroup>
    <NuGetPackageFiles Include="$(NuGetPackageRoot)**/lib/net5.0/*.dll" />
  </ItemGroup>
  <Copy SourceFiles="@(NuGetPackageFiles)" DestinationFolder="./nuget-dlls" OverwriteReadOnlyFiles="true" />
</Target>

然后执行以下命令，自动完成还原并复制DLL到统一目录：

dotnet msbuild /t:CopyNuGetDllsToSingleFolder /p:TargetFramework=net5.0

注意事项 #

• 如果项目依赖私有NuGet源，需确保dotnet restore能正常访问该源，否则依赖包无法下载。
• 若存在同名DLL（不同版本），复制时会自动覆盖；如需保留所有版本，可修改脚本为DLL文件名添加版本后缀。

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