Visual Studio中CMake Qt项目添加Qt目录至PATH的最优方法

方法1：在CMakeSettings.json中为所有构建配置统一设置环境变量 #

打开项目的CMakeSettings.json，给Debug、Release等所有构建配置节点都添加VS_DEBUGGER_ENVIRONMENT属性，将Qt二进制目录加入PATH，同时用自定义变量统一管理路径避免重复：

{
  "configurations": [
    {
      "name": "Debug",
      "generator": "Ninja",
      "configurationType": "Debug",
      "inheritEnvironments": [ "msvc_x64_x64" ],
      "VS_DEBUGGER_ENVIRONMENT": "PATH=$(QtBinPath);%PATH%",
      "variables": [
        {
          "name": "CMAKE_PREFIX_PATH",
          "value": "C:/Qt/6.5.3/msvc2019_64"
        },
        {
          "name": "QtBinPath",
          "value": "C:/Qt/6.5.3/msvc2019_64/bin"
        }
      ]
    },
    {
      "name": "Release",
      "generator": "Ninja",
      "configurationType": "Release",
      "inheritEnvironments": [ "msvc_x64_x64" ],
      "VS_DEBUGGER_ENVIRONMENT": "PATH=$(QtBinPath);%PATH%",
      "variables": [
        {
          "name": "CMAKE_PREFIX_PATH",
          "value": "C:/Qt/6.5.3/msvc2019_64"
        },
        {
          "name": "QtBinPath",
          "value": "C:/Qt/6.5.3/msvc2019_64/bin"
        }
      ]
    }
  ]
}

此配置会让Debug和Release模式都能通过PATH找到Qt的DLL文件。

方法2：正确配置launch.vs.json #

如果之前配置失败，大概率是目标或环境变量格式有误，按以下步骤操作：

1. 右键点击项目根目录的CMakeLists.txt，选择「调试和启动设置」，自动生成launch.vs.json。
2. 修改文件内容，给目标程序添加environment字段：

{
  "version": "0.2.1",
  "defaults": {},
  "configurations": [
    {
      "type": "default",
      "project": "CMakeLists.txt",
      "projectTarget": "your_app_name.exe",
      "name": "your_app_name.exe",
      "environment": [
        {
          "name": "PATH",
          "value": "C:/Qt/6.5.3/msvc2019_64/bin;%PATH%"
        }
      ]
    }
  ]
}

替换your_app_name.exe为你的实际可执行文件名，C:/Qt/6.5.3/msvc2019_64/bin为你的Qt二进制目录，该配置对所有构建模式生效。

方法3：全局配置Visual Studio用户环境变量 #

如果希望所有CMake项目都自动继承该设置，可配置VS全局环境变量：

• 点击顶部菜单「工具」->「选项」->「项目和解决方案」->「VC++项目设置」。
• 在「用户宏」中添加QT_BIN_PATH，值设为Qt二进制目录。
• 编辑「环境」中的PATH为$(QT_BIN_PATH);%PATH%。
• 重启VS后，所有项目都会自动应用该PATH配置。

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