VS2019加载QT项目时.vcxproj的Import声明触发报错如何解决？

问题根因 #

这是VS 2019加载嵌套解决方案时的MSBuild属性评估时序缺陷：子项目初始加载阶段，父解决方案的全局属性还未注入到子项目的MSBuild上下文，此时$(SolutionName)宏会返回空值，只有等后续项目初始化完成后宏才会被正确赋值。你观察到的「加任意字符后宏能正常取值」是VS增量评估的偶现触发，属于非预期行为。

修复步骤 #

• 第一步：清理重复导入声明
  直接删除.vcxproj文件中重复的2条<Import Project="$(SolutionDir)\$(SolutionName).props" />声明，仅保留1条即可，解决重复导入的基础问题。
• 第二步：修正导入节点的判断逻辑
  将保留的Import节点修改为以下写法，新增$(SolutionName)非空判断，确保只有宏正确赋值后才会执行导入逻辑：

  <Import Project="$(SolutionDir)$(SolutionName).props" Condition="'$(SolutionName)' != '' And Exists('$(SolutionDir)$(SolutionName).props')" />
  

  注意：不要在$(SolutionDir)后额外加反斜杠，该宏本身返回的路径默认带末尾反斜杠
• 第三步（兜底方案，优先推荐）：绕开$(SolutionName)宏直接指定路径
  因为你的所有子解决方案都统一使用父解决方案的.props文件，父解决方案名称是固定值，直接硬编码路径即可彻底规避宏取值问题，示例写法（根据你实际的.props相对路径调整层级）：

  <Import Project="$([System.IO.Path]::GetFullPath('$(MSBuildThisFileDirectory)..\..\你的父解决方案名称.props'))" Condition="Exists('$([System.IO.Path]::GetFullPath('$(MSBuildThisFileDirectory)..\..\你的父解决方案名称.props'))')" />
  

• 第四步：禁用QT插件自动生成导入配置
  打开QT VS Tools扩展的项目设置，关闭「自动生成解决方案.props导入声明」的相关选项，避免后续编译时插件重新插入重复的Import节点。
• 第五步：清理缓存验证
  关闭所有VS窗口，删除解决方案根目录的.vs隐藏文件夹，删除所有子项目的.vcxproj.user配置文件，重新打开父解决方案等待完全加载后即可消除报错。

补充说明 #

你之前尝试仅加文件存在判断不生效的原因是，评估时$(SolutionName)为空，拼接出的路径本身不合法，自然会触发后台构建失败。该修复不会影响项目正常编译，也消除了后续props导入异常的潜在风险。

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