如何基于packages.lock.json将.NET项目PackageReference浮动版本转为严格版本？

针对你的需求，结合现有packages.lock.json和项目配置，有以下几种可行方法将PackageReference的浮动版本替换为精确版本：

方法一：自动化脚本替换（推荐） #

通过脚本读取packages.lock.json中的精确版本，批量更新所有.csproj文件的浮动版本，适合多项目场景。

Windows环境（PowerShell脚本） #

# 读取并解析packages.lock.json
$lockContent = Get-Content -Path "packages.lock.json" | ConvertFrom-Json

# 遍历lock文件中记录的所有包信息
foreach ($frameworkGroup in $lockContent.packages.PSObject.Properties) {
    foreach ($package in $frameworkGroup.Value) {
        $pkgName = $package.name
        $exactVersion = $package.version

        # 递归查找所有csproj文件并更新版本
        Get-ChildItem -Recurse -Filter "*.csproj" | ForEach-Object {
            $projPath = $_.FullName
            $xml = [xml](Get-Content $projPath)
            $nsManager = New-Object System.Xml.XmlNamespaceManager($xml.NameTable)
            $nsManager.AddNamespace("ms", "http://schemas.microsoft.com/developer/msbuild/2003")

            # 定位当前包的PackageReference节点
            $refNodes = $xml.SelectNodes("//ms:PackageReference[@Include='$pkgName']", $nsManager)
            foreach ($node in $refNodes) {
                # 仅替换带有浮动标记（*）的版本
                if ($node.Version -match '\*') {
                    $node.Version = $exactVersion
                    Write-Host "已更新 $pkgName 在 $projPath 中的版本至 $exactVersion"
                }
            }
            $xml.Save($projPath)
        }
    }
}

Linux/macOS环境（Bash脚本） #

# 解析packages.lock.json，提取包名和对应精确版本
jq -r '.packages[] | to_entries[] | .value | "\(.name)|\(.version)"' packages.lock.json | while IFS="|" read -r pkg_name pkg_version; do
    # 遍历所有csproj文件，替换浮动版本
    find . -name "*.csproj" -type f | while read -r proj_file; do
        # 仅匹配包含*的Version属性并替换
        sed -i '' "s/<PackageReference Include=\"$pkg_name\" Version=\"[^\"]*\*[^\"]*\"/<PackageReference Include=\"$pkg_name\" Version=\"$pkg_version\"/" "$proj_file"
    done
    echo "已更新 $pkg_name 版本至 $pkg_version"
done

方法二：手动替换+锁定验证 #

适合项目数量少的场景：

1. 直接查看packages.lock.json文件，找到每个浮动版本包对应的精确版本号
2. 逐个编辑.csproj文件，将Version="X.*"替换为对应的精确版本（如Version="12.0.4"）
3. 替换完成后，运行dotnet restore --locked-mode验证版本一致性，确保所有包都使用lock文件中的版本

额外加固：启用锁定模式 #

为了在冻结期彻底防止版本意外更新，可在发布分支的项目文件中添加以下配置：

<PropertyGroup>
  <!-- 强制restore时使用packages.lock.json的版本，禁止自动更新 -->
  <RestoreLockedMode>true</RestoreLockedMode>
</PropertyGroup>

冻结期结束后，只需将版本改回浮动格式（如12.*），并移除RestoreLockedMode配置，即可恢复滚动更新策略。

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