如何用PowerShell批量更改.NET目标框架？解决属性设置失败问题

问题描述 #

VS2022暂不支持批量修改.NET目标框架，尝试编写PowerShell脚本批量修改解决方案中.NET项目的TargetFramework，但执行时出现错误：

原脚本 #

function ToColor($color) {
    process { Write-Host $_ -ForegroundColor $color }
}
function GetProjects() {
    $dir = "C:\Users\username\repos\solution"
    $bins = Get-ChildItem -Filter *.csproj -Recurse -Path $dir
    $count = ($bins | measure).count
    return $bins
}
function SetVersion($file, $ver) {
    $xml = [xml](Get-Content $file)
    $name = $file.BaseName
    $currentVersion = ([string]$xml.Project.PropertyGroup.TargetFramework).Trim()
    if($ver -eq 5){
        $xml.Project.PropertyGroup.TargetFramework = "net5.0-windows"
    }
    if($ver -eq 6){
        $xml.Project.PropertyGroup.TargetFramework = "net6.0-windows"
    }
    if($ver -eq 7){
        $xml.Project.PropertyGroup.TargetFramework = "net7.0-windows"
    }
    $newv = ([string]$xml.Project.PropertyGroup.TargetFramework).Trim()

    "Setting new version for: "
    "$file"
    "[$currentVersion -> $newv]" | tocolor "green"
    # $xml.Save($file)
}

foreach ($p in GetProjects) {
    SetVersion $p.fullname 6
}

项目文件示例 #

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net5.0-windows</TargetFramework>
    <OutputType>Library</OutputType>

错误信息 #

Setting new version for:
C:\Users\username\SolutionName\WpfDx12\WPFDX12.csproj
[net5.0-windows -> net5.0-windows]
The property 'TargetFramework' cannot be found on this object. Verify that the property exists and can be set.
At C:\Users\username\SolutionName\SetNetVersion.ps1:20 char:3
+         $xml.Project.PropertyGroup.TargetFramework = "net6.0-windows"
+         ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : InvalidOperation: (:) [], RuntimeException
    + FullyQualifiedErrorId : PropertyAssignmentException

原因分析 #

错误的核心原因是：当项目文件中存在多个<PropertyGroup>节点时（比如区分Debug/Release配置的PropertyGroup），$xml.Project.PropertyGroup会返回一个节点数组，而非单个节点对象。直接对数组访问.TargetFramework属性并赋值，PowerShell会抛出“属性不存在”的错误——因为数组本身没有这个属性，只有单个节点才有。

此外，脚本读取$xml.Project.PropertyGroup.TargetFramework时，PowerShell会隐式取数组第一个元素的属性值，这就是为什么能看到当前版本，但赋值时却失败的原因。

修复后的脚本 #

修改后的脚本通过精准定位节点解决了数组问题，同时优化了逻辑健壮性：

function ToColor($color) {
    process { Write-Host $_ -ForegroundColor $color }
}

function GetProjects() {
    $dir = "C:\Users\username\repos\solution"
    return Get-ChildItem -Filter *.csproj -Recurse -Path $dir
}

function SetVersion($filePath, $targetVer) {
    # 加载XML文件，更好处理编码和格式
    $xml = New-Object System.Xml.XmlDocument
    $xml.Load($filePath)

    # 用XPath精准定位TargetFramework节点
    $targetFrameworkNode = $xml.SelectSingleNode("//Project/PropertyGroup/TargetFramework")
    if (-not $targetFrameworkNode) {
        "项目 $filePath 中未找到TargetFramework节点" | ToColor "red"
        return
    }

    $currentVersion = $targetFrameworkNode.InnerText.Trim()
    # 根据目标版本设置新值
    switch ($targetVer) {
        5 { $newVersion = "net5.0-windows" }
        6 { $newVersion = "net6.0-windows" }
        7 { $newVersion = "net7.0-windows" }
        default { 
            "不支持的目标版本: $targetVer" | ToColor "red"
            return
        }
    }

    if ($currentVersion -eq $newVersion) {
        "项目 $filePath 已经是目标版本 $newVersion，无需修改" | ToColor "yellow"
        return
    }

    # 修改并保存
    $targetFrameworkNode.InnerText = $newVersion
    $xml.Save($filePath)

    "已修改项目: $filePath"
    "[$currentVersion -> $newVersion]" | ToColor "green"
}

# 遍历所有项目，修改为.NET 6
foreach ($proj in GetProjects) {
    SetVersion $proj.FullName 6
}

关键优化点 #

• 使用SelectSingleNode结合XPath精准定位TargetFramework节点，彻底避免多个PropertyGroup带来的数组问题
• 增加节点不存在的判断，避免无意义的错误抛出
• 用switch语句替代多个if，逻辑更简洁清晰
• 添加版本已匹配的判断，跳过无需修改的项目
• 使用XmlDocument.Load()替代Get-Content，更好地处理XML编码和格式兼容性

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