如何恢复损坏的Visual Studio C++类图及团队共享编辑方法

手动编辑路径后触发项目类型不支持报错，和UUID无关，按以下步骤排查修复即可：

• 首先检查文件项类型配置：在VS解决方案资源管理器中找到对应.cd文件，右键打开属性面板，确认项类型字段选中的是类图。手动编辑文件内容后VS经常会误将.cd文件识别为杂项文件，直接触发该报错，改回正确项类型后重载文件即可恢复。
• 其次检查XML结构合法性：.cd文件作为XML格式配置，根节点<ClassDiagram>必须保留完整的版本属性，类节点的路径字段不要直接写裸相对路径，原生类设计器不支持裸相对路径解析，但是支持VS内置工程宏，可以将固定的本地绝对路径前缀替换为$(ProjectDir)（对应项目根目录）、$(SolutionDir)（对应解决方案根目录）这类宏，既可以实现跨设备路径适配，也不会触发解析错误。合法的类节点路径配置示例：

<Class Name="MyC++Class" ProjectItem="myclass.h" FilePath="$(ProjectDir)src\myclass.h" />

• 如果以上两步操作后仍无法打开，直接在项目中新建一个空白类图文件，将原.cd文件中除根节点属性外的所有类、关联关系节点内容复制到新文件中保存，即可正常加载编辑，比零散排查配置错误效率高很多。

对应报错提示：Class diagrams are not supported by the project type. Add the class diagram file to a C#, VB or C++ project and try opening it again.（此项目类型不支持类图，请将类图文件添加到C#、VB或C++项目后重试打开）

• 原生.cd文件入库方案：将所有类节点路径统一替换为$(ProjectDir)等宏路径，在不同设备上验证可以正常加载后，直接将.cd文件提交到代码仓库，提交前注意检查不要残留本地绝对路径。该方案无需安装第三方插件，所有成员可以直接使用VS原生类设计器编辑，和代码联动性最好。
• 纯文本类图方案：使用PlantUML这类纯文本格式的类图描述语言，将类图源文件提交到仓库，团队成员安装对应的VS插件即可直接在开发环境中预览、编辑类图，不存在路径兼容问题，缺点是和C++代码的自动联动能力弱于原生类设计器，需要手动同步代码和类图变更。
• 目录约定+自动替换方案：团队统一约定本地仓库的拉取目录层级，搭配简单的git钩子脚本，提交.cd文件时自动将本地绝对路径替换为统一占位符，拉取代码时自动将占位符替换为成员本地的实际路径，稳定性高，适合对类图编辑功能要求高、不方便更换工具的团队。

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