为何Visual Studio 2022编辑依赖时提示System.Guid转换错误？

问题场景 #

在Visual Studio 2022（17.4.2）中，为图形应用测试平台项目添加共享项目（.shproj）引用时，右键选择「添加项目引用...」或「添加共享项目引用...」编辑依赖，会弹出错误对话框：

---------------------------
Microsoft Visual Studio
---------------------------
String value ' 

      ' cannot be translated to any value from type System.Guid.
---------------------------
OK   
---------------------------

撤销操作后错误仍存在，但该项目在Visual Studio 2019中可正常编辑依赖，修改后的项目能在VS2022中正常加载和构建。

排查与解决步骤 #

1. 检查并修复.csproj文件中的无效引用节点 #

用文本编辑器（如Notepad++、VS Code）打开项目的.csproj文件，重点检查以下内容：

• 查找<ProjectReference>或<SharedProjectReference>节点，确认是否存在包含大量空白（空格/换行）的Include或Project属性值，比如类似<ProjectReference Include=" ">的无效条目，直接删除这类损坏的节点。
• 检查所有<ItemGroup>下的引用节点，删除空的引用条目，或修正格式错误的Guid值（标准Guid格式为8-4-4-4-12的十六进制字符串）。

2. 清理解决方案.sln文件中的无效项目条目 #

打开解决方案的.sln文件，进行以下检查：

• 查找所有以Project(开头的行，确认每个项目的第三个参数（项目Guid）是否有效，若存在类似Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "", "", " "的空白Guid条目，直接删除该行。
• 检查GlobalSection(ProjectConfigurationPlatforms)和GlobalSection(SolutionConfigurationPlatforms)区块，删除对应无效项目的配置项，避免残留的无效配置干扰VS解析。

3. 清除Visual Studio 2022缓存 #

关闭VS2022，删除以下目录的缓存文件：

• %LOCALAPPDATA%\Microsoft\VisualStudio\17.0_<随机后缀>\ComponentModelCache
• %USERPROFILE%\AppData\Local\Temp\VisualStudioProjectSystem
  重启VS后再尝试添加引用操作。

4. 修复VS2022安装 #

打开Visual Studio安装器，选择对应的VS2022实例点击「修改」，然后选择「修复」选项，修复可能损坏的项目系统组件，尤其是与共享项目、依赖管理相关的模块。

5. 手动添加共享项目引用 #

若UI操作持续报错，可绕过VS的引用编辑UI，手动编辑.csproj文件添加共享项目引用：

<ItemGroup>
  <SharedProjectReference Include="..\相对路径\你的共享项目名称.shproj" />
</ItemGroup>

保存文件后重新加载项目，VS2022会正常识别该引用，后续其他依赖修改也可采用这种手动方式。

原因分析 #

VS2022的项目系统对项目文件的格式校验逻辑比VS2019更严格，当.csproj或.sln文件中存在空白Guid占位符、损坏的引用节点时，VS2022的引用编辑UI在解析这些无效内容时会触发Guid转换错误；而VS2019的解析逻辑相对宽松，能够忽略这类无效条目正常完成依赖编辑操作。

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