如何使用NuGet.Core为C#项目文件添加NuGet包及批量升级旧项目

听起来你已经走在正确的路上了！用NuGet.Core来批量更新csproj文件确实是个高效的方案，我来帮你把这个思路补全，让整个批量处理流程更顺畅。

1. 完善依赖映射与包查找逻辑 #

你已经初始化了本地NuGet仓库，接下来可以把程序集到NuGet包的映射做扎实——尤其要结合程序集版本号来精准匹配（毕竟同一个程序集可能对应不同版本的NuGet包）。这里给你补全这部分的代码示例：

// 预先定义程序集名到NuGet包ID的映射字典
var assemblyToPackageMap = new Dictionary<string, string>
{
    { "OldAssemblyA", "Company.OldAssemblyA" },
    { "OldAssemblyB", "Company.OldAssemblyB" }
};

// 从本地仓库查找匹配版本的NuGet包
Package FindMatchingPackage(IPackageRepository localRepo, string assemblyName, Version assemblyVersion)
{
    if (!assemblyToPackageMap.TryGetValue(assemblyName, out var packageId))
        return null;

    // 这里用主版本+次版本匹配，你可以根据需求调整规则（比如完全匹配、兼容更新等）
    return localRepo.FindPackagesById(packageId)
        .Where(p => p.Version.Major == assemblyVersion.Major && p.Version.Minor == assemblyVersion.Minor)
        .OrderByDescending(p => p.Version)
        .FirstOrDefault();
}

2. 解析与修改csproj文件 #

核心的项目文件处理环节，建议用Microsoft.Build库来操作——比直接修改XML更安全，能兼容旧版非SDK样式和新版SDK样式的csproj文件。

完整处理流程代码： #

using Microsoft.Build.Evaluation;
using System.Reflection;

// 初始化MSBuild项目集合，确保能正确加载项目
var projectCollection = new ProjectCollection();
var globalProps = new Dictionary<string, string>
{
    { "Configuration", "Debug" },
    { "Platform", "AnyCPU" }
};

// 遍历目标目录下所有csproj文件
foreach (var csprojPath in Directory.EnumerateFiles(@"C:\YourProjectsRoot", "*.csproj", SearchOption.AllDirectories))
{
    var project = new Project(csprojPath, globalProps, null, projectCollection);
    var referencesToRemove = new List<ProjectItem>();
    var packagesToAdd = new List<(string PackageId, string Version)>();

    // 遍历项目中的所有程序集引用
    foreach (var reference in project.GetItems("Reference"))
    {
        var assemblyName = reference.EvaluatedInclude;
        var hintPath = reference.GetMetadataValue("HintPath");
        
        // 通过HintPath解析程序集版本
        if (!string.IsNullOrEmpty(hintPath) && File.Exists(hintPath))
        {
            var assemblyInfo = AssemblyName.GetAssemblyName(hintPath);
            var matchingPackage = FindMatchingPackage(localRepo, assemblyInfo.Name, assemblyInfo.Version);
            
            if (matchingPackage != null)
            {
                referencesToRemove.Add(reference);
                packagesToAdd.Add((matchingPackage.Id, matchingPackage.Version.ToString()));
            }
        }
    }

    // 移除旧的程序集引用
    foreach (var refToRemove in referencesToRemove)
    {
        project.RemoveItem(refToRemove);
    }

    // 添加NuGet包引用，区分SDK/非SDK项目
    var isSdkStyle = project.GetProperty("TargetFramework") != null;
    foreach (var (packageId, version) in packagesToAdd)
    {
        if (isSdkStyle)
        {
            // SDK样式项目直接添加PackageReference节点
            project.AddItem("PackageReference", packageId, new Dictionary<string, string>
            {
                { "Version", version }
            });
        }
        else
        {
            // 非SDK样式项目需要更新packages.config，用NuGet.Core的PackageManager处理
            var packagesConfigPath = Path.Combine(Path.GetDirectoryName(csprojPath), "packages.config");
            if (File.Exists(packagesConfigPath))
            {
                var packageManager = new PackageManager(localRepo, Path.GetDirectoryName(csprojPath));
                packageManager.InstallPackage(packageId, new SemanticVersion(version), ignoreDependencies: false);
            }
        }
    }

    // 保存修改后的项目文件
    project.Save();
}

3. 关键注意事项与优化点 #

• 备份优先：批量修改前一定要给所有项目做备份，或者用Git等版本控制工具兜底，避免误操作。
• 版本匹配灵活调整：根据你的需求修改版本匹配逻辑——比如可以强制用最新稳定版，或者严格匹配程序集的完整版本号。
• 异常处理：给遍历和修改环节添加异常捕获，记录无法处理的项目或引用，方便后续排查。
• 先测试再批量：找几个代表性项目做测试，确认修改后能正常编译，再推进到所有项目。

4. 可选替代方案 #

如果不想自己写代码，也可以用nuget.exe结合PowerShell脚本批量处理，但灵活性不如自定义C#程序——比如用nuget install安装包后替换引用，但处理不同项目格式时会比较繁琐。

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