.NET Core与.NET Framework下以编程方式还原NuGet包

嘿，这个需求我刚好在做内部工具的时候实践过，分不同项目类型和包管理方式给你拆解可行的实现思路，两种主流方向（命令行调用/原生API）都覆盖到：

首先得明确：

• .NET Framework项目分两种包管理模式：packages.config 和 PackageReference
• .NET Core/.NET 5+ 统一用 PackageReference，没有packages.config的说法

这种方式最简单，直接调用官方的NuGet命令行工具，不需要处理复杂的API细节，适合大多数场景。

2.1 .NET Framework + packages.config #

用nuget.exe的restore命令，编程方式启动进程执行即可：

using System.Diagnostics;

var projectPath = @"C:\YourProject\MyFrameworkProject.csproj";
var nugetExePath = @"C:\Tools\nuget.exe"; // 或者用环境变量里的nuget

var processStartInfo = new ProcessStartInfo
{
    FileName = nugetExePath,
    Arguments = $"restore \"{projectPath}\" -Source https://api.nuget.org/v3/index.json",
    RedirectStandardOutput = true,
    RedirectStandardError = true,
    UseShellExecute = false,
    CreateNoWindow = true
};

using var process = Process.Start(processStartInfo);
process.WaitForExit();

string output = process.StandardOutput.ReadToEnd();
string error = process.StandardError.ReadToEnd();

if (process.ExitCode != 0)
{
    throw new Exception($"NuGet restore failed: {error}");
}

2.2 .NET Framework（PackageReference）/ .NET Core/.NET 5+ #

直接用dotnet restore命令，这个命令统一支持两种项目类型：

using System.Diagnostics;

var projectOrSolutionPath = @"C:\YourProject\MyProject.sln"; // 支持项目文件或解决方案

var processStartInfo = new ProcessStartInfo
{
    FileName = "dotnet",
    Arguments = $"restore \"{projectOrSolutionPath}\" --source https://api.nuget.org/v3/index.json",
    RedirectStandardOutput = true,
    RedirectStandardError = true,
    UseShellExecute = false,
    CreateNoWindow = true
};

using var process = Process.Start(processStartInfo);
process.WaitForExit();

string output = process.StandardOutput.ReadToEnd();
string error = process.StandardError.ReadToEnd();

if (process.ExitCode != 0)
{
    throw new Exception($"Dotnet restore failed: {error}");
}

如果需要更灵活的控制（比如自定义日志、私有源认证、实时进度回调），可以用NuGet官方的Client SDK。

3.1 依赖包准备 #

先在你的工具项目里安装这些NuGet包：

• NuGet.Commands
• NuGet.Configuration
• NuGet.PackageManagement
• NuGet.ProjectModel

3.2 核心代码示例（以PackageReference项目为例） #

using NuGet.Common;
using NuGet.Commands;
using NuGet.Configuration;
using NuGet.ProjectModel;

// 1. 设置包源
var settings = Settings.LoadDefaultSettings(root: null);
var packageSources = PackageSourceProvider.LoadPackageSources(settings);

// 2. 准备Restore参数
var restoreRequest = new RestoreRequest(
    solutionPath: @"C:\YourProject\MyProject.sln",
    projectPaths: null, // 传null会处理整个解决方案
    packageSources,
    new RestoreSettings
    {
        CacheDirectory = Environment.GetFolderPath(Environment.SpecialFolder.UserProfile) + @"\.nuget\packages",
        DisableParallelRestores = false,
        LogLevel = LogLevel.Information
    });

// 3. 执行Restore
var restoreManager = new RestoreManager(settings);
var restoreResult = await restoreManager.RestoreAsync(restoreRequest, new ConsoleLogger());

if (!restoreResult.Success)
{
    throw new Exception("NuGet restore failed via API");
}

3.3 针对packages.config的.NET Framework项目 #

需要用NuGet.PackageManagement里的PackageInstaller相关类，核心思路是：

• 加载项目的packages.config文件
• 获取包源列表
• 遍历需要安装的包，调用InstallPackageAsync方法（注：Restore本质就是安装缺失的包）

• 私有源认证：如果用私有NuGet源，命令行方式可以加-Username/-Password参数，API方式需要在PackageSource里设置认证信息
• 环境变量：确保nuget.exe或dotnet命令在系统PATH里，或者指定完整路径
• 日志与错误处理：一定要捕获输出和错误信息，方便排查问题
• 并行恢复：大解决方案可以开启并行恢复提升速度，API里设置DisableParallelRestores = false即可

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