如何让dotnet CLI添加带<Name>的ProjectReference与VS一致？

核心问题 #

dotnet add reference命令默认只生成包含Include属性的<ProjectReference>节点，而Visual Studio 2022添加引用时会额外包含<Project>（目标项目GUID）和<Name>（目标项目名称）子节点。由于CLI本身没有直接支持生成完整节点的参数，我们需要通过脚本自动化提取目标项目信息并修改csproj文件来实现一致效果。

VS生成的完整节点格式 #

VS添加引用后，csproj中会生成如下结构：

<ProjectReference Include="..\Library\MySecondLibrary.csproj">
  <Project>{目标项目的GUID}</Project>
  <Name>MySecondLibrary</Name>
</ProjectReference>

其中：

• <Project>的值来自目标项目csproj中的<ProjectGuid>节点
• <Name>的值优先取目标项目的<AssemblyName>，未设置时则使用项目文件名

自动化批量解决方案 #

Windows环境：PowerShell脚本 #

以下脚本可批量添加带完整属性的项目引用，步骤包括提取目标项目信息、添加基础引用、补全缺失节点：

param(
    [string]$TargetProjectPath,
    [string]$ReferencedProjectPath
)

# 读取被引用项目的GUID和AssemblyName
$referencedProj = [xml](Get-Content $ReferencedProjectPath)
$projectGuid = $referencedProj.Project.PropertyGroup.ProjectGuid
$assemblyName = $referencedProj.Project.PropertyGroup.AssemblyName

# 未设置AssemblyName时用项目文件名替代
if (-not $assemblyName) {
    $assemblyName = [System.IO.Path]::GetFileNameWithoutExtension($ReferencedProjectPath)
}

# 添加基础引用（避免重复添加）
dotnet add $TargetProjectPath reference $ReferencedProjectPath

# 读取并修改目标项目的csproj
$targetProj = [xml](Get-Content $TargetProjectPath)
$ns = New-Object System.Xml.XmlNamespaceManager($targetProj.NameTable)
$ns.AddNamespace("msbuild", "http://schemas.microsoft.com/developer/msbuild/2003")

$referenceNode = $targetProj.SelectSingleNode("//msbuild:ProjectReference[@Include='$ReferencedProjectPath']", $ns)
if ($referenceNode) {
    # 添加Project子节点
    $projectNode = $targetProj.CreateElement("Project", "http://schemas.microsoft.com/developer/msbuild/2003")
    $projectNode.InnerText = $projectGuid
    $referenceNode.AppendChild($projectNode) | Out-Null

    # 添加Name子节点
    $nameNode = $targetProj.CreateElement("Name", "http://schemas.microsoft.com/developer/msbuild/2003")
    $nameNode.InnerText = $assemblyName
    $referenceNode.AppendChild($nameNode) | Out-Null

    $targetProj.Save($TargetProjectPath)
}

批量调用示例

将脚本保存为Add-ProjectReferenceWithProps.ps1，然后循环处理多个引用：

$consoleProj = ".\ConsoleProject\ConsoleProject.csproj"
$libraryProjects = @(
    ".\Library\MyLibrary.csproj",
    ".\Library\MySecondLibrary.csproj"
)

foreach ($lib in $libraryProjects) {
    .\Add-ProjectReferenceWithProps.ps1 -TargetProjectPath $consoleProj -ReferencedProjectPath $lib
}

Linux/macOS环境：Bash脚本（依赖xmlstarlet） #

需要先安装xmlstarlet工具（用于XML操作），脚本逻辑和PowerShell一致：

#!/bin/bash

TARGET_PROJECT="$1"
REFERENCED_PROJECT="$2"

# 提取目标项目的GUID
PROJECT_GUID=$(xmlstarlet sel -N ms=http://schemas.microsoft.com/developer/msbuild/2003 -t -v "/ms:Project/ms:PropertyGroup/ms:ProjectGuid" "$REFERENCED_PROJECT")
# 提取AssemblyName，未设置则用项目文件名
ASSEMBLY_NAME=$(xmlstarlet sel -N ms=http://schemas.microsoft.com/developer/msbuild/2003 -t -v "/ms:Project/ms:PropertyGroup/ms:AssemblyName" "$REFERENCED_PROJECT")
if [ -z "$ASSEMBLY_NAME" ]; then
    ASSEMBLY_NAME=$(basename "$REFERENCED_PROJECT" .csproj)
fi

# 添加基础引用
dotnet add "$TARGET_PROJECT" reference "$REFERENCED_PROJECT"

# 补全Project和Name子节点
xmlstarlet ed -N ms=http://schemas.microsoft.com/developer/msbuild/2003 \
    -s "/ms:Project/ms:ItemGroup/ms:ProjectReference[@Include='$REFERENCED_PROJECT']" -t elem -n Project -v "$PROJECT_GUID" \
    -s "/ms:Project/ms:ItemGroup/ms:ProjectReference[@Include='$REFERENCED_PROJECT']" -t elem -n Name -v "$ASSEMBLY_NAME" \
    "$TARGET_PROJECT"

批量调用示例

# 安装xmlstarlet（Ubuntu/Debian为例）
sudo apt install xmlstarlet

# 定义路径并批量执行
console_proj="./ConsoleProject/ConsoleProject.csproj"
library_projects=(
    "./Library/MyLibrary.csproj"
    "./Library/MySecondLibrary.csproj"
)

for lib in "${library_projects[@]}"; do
    ./add-reference.sh "$console_proj" "$lib"
done

注意事项 #

1. 确保被引用项目的csproj中存在<ProjectGuid>节点（VS创建的项目默认包含，手动创建的项目需自行添加）
2. 脚本执行前建议备份csproj文件，避免意外修改
3. 脚本会自动处理重复引用的情况，不会重复添加节点

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