Qt Visual Studio插件无法保存已添加Qt版本的问题咨询

1. 报错日志查询路径 #

• Visual Studio 全局活动日志：默认存储路径为 %APPDATA%\Microsoft\VisualStudio\16.0_<随机字符后缀>\ActivityLog.xml，若需要更完整的插件运行日志，可右键Visual Studio 2019快捷方式，在「目标」字段末尾添加 /log 参数，重启VS后会生成全量运行日志，其中包含Qt插件配置读写的所有报错信息。
• Qt Visual Studio Tools 专属日志：进入VS选项路径 选项 -> Qt -> General，勾选启用日志记录（Enable logging）选项后，插件运行日志会输出到 %LOCALAPPDATA%\Qt\QtVisualStudioTools\Logs 目录，日志文件会完整记录Qt版本添加、配置保存的操作流程和错误栈。

2. 插件配置文件存储路径及手动配置方法 #

全局Qt版本配置路径 #

2.7.2.2版本的全局Qt版本配置存储在 %LOCALAPPDATA%\Qt\QtVisualStudioTools\2.7.2.2\QtVersions.xml 文件中，该配置对所有VS项目生效。

• 若对应路径下无该文件，可手动创建，文件根节点为 <QtVersions></QtVersions>
• 手动添加Qt版本时，在根节点内插入如下格式的配置，替换为你本地的Qt路径、版本名称、编译器标识即可：

<QtVersion>
  <Name>Qt 5.15.2 MSVC2019 64位</Name>
  <Path>C:\Qt\5.15.2\msvc2019_64</Path>
  <Compiler>msvc2019_64</Compiler>
  <IsDefault>true</IsDefault>
</QtVersion>

• 注意：修改配置前需要完全关闭所有Visual Studio进程，避免配置被进程覆盖，修改完成后重启VS即可识别手动添加的Qt版本。

单项目Qt配置路径 #

针对单个项目的Qt配置存储在项目根目录的 .vs\QtProjectSettings.json 文件中，仅对当前项目生效。

常见异常原因排查 #

如果出现配置保存后自动消失的情况，可先检查QtVersions.xml文件是否被设置为只读，以及当前Windows用户对该文件所在目录是否有写入权限，权限不足是该问题的高频诱因。

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