Windows下VSCode中CMake+MinGW(Qt项目)自动添加链接库路径至执行环境

针对你遇到的问题，这里提供几个实用的本地运行解决方案，不需要手动维护launch.json的PATH，也能实现类似Qt Creator自动加载库路径或Linux rpath的效果：

方案1：用CMake自动生成带环境变量的启动脚本 #

CMake可以在构建阶段自动生成批处理（.bat）脚本，把对应构建类型的Qt DLL路径和其他依赖库路径注入到运行时PATH中，直接双击脚本就能运行程序，也能在VSCode里调用这个脚本执行。

具体做法：

• 在CMakeLists.txt中，根据CMAKE_BUILD_TYPE区分Release/Debug的Qt DLL路径：

  # 假设已通过find_package获取到Qt的安装目录QT_DIR
  if(CMAKE_BUILD_TYPE STREQUAL "Debug")
      set(QT_DLL_DIR ${QT_DIR}/bin) # Qt Debug DLL通常带d后缀，存于bin目录
  else()
      set(QT_DLL_DIR ${QT_DIR}/bin) # Release DLL路径
  endif()
  
  # 生成运行脚本，自动设置PATH并启动程序
  add_custom_command(TARGET ${PROJECT_NAME} POST_BUILD
      COMMAND ${CMAKE_COMMAND} -E echo "set PATH=${QT_DLL_DIR};${CMAKE_CURRENT_BINARY_DIR}/lib;%PATH%" > run_${PROJECT_NAME}.bat
      COMMAND ${CMAKE_COMMAND} -E echo "${CMAKE_CURRENT_BINARY_DIR}/${CMAKE_BUILD_TYPE}/${PROJECT_NAME}.exe" >> run_${PROJECT_NAME}.bat
      WORKING_DIRECTORY ${CMAKE_CURRENT_BINARY_DIR}
      COMMENT "Generating run script..."
  )
  

  每次构建后，构建目录会生成对应类型的run_xxx.bat，运行脚本时会自动把需要的DLL路径加到PATH，再启动程序。

方案2：给MinGW编译的程序添加类似Linux rpath的加载路径 #

MinGW的链接器支持-rpath参数，虽然Windows本身没有rpath原生支持，但MinGW实现了类似机制——让可执行文件在加载时优先从指定路径查找DLL。

在CMakeLists.txt中给目标添加链接参数：

if(MINGW)
    if(CMAKE_BUILD_TYPE STREQUAL "Debug")
        set(QT_DLL_RPATH "${QT_DIR}/bin")
    else()
        set(QT_DLL_RPATH "${QT_DIR}/bin")
    endif()
    # $ORIGIN表示可执行文件所在目录，可根据实际目录结构调整相对路径
    set_target_properties(${PROJECT_NAME} PROPERTIES
        LINK_FLAGS "-Wl,-rpath,${QT_DLL_RPATH}"
    )
endif()

编译后的可执行文件会记住DLL的查找路径，无需手动设置PATH就能直接运行。如果依赖库在构建目录的子文件夹，可改用$ORIGIN/../lib这类相对路径。

方案3：配置VSCode Tasks自动切换PATH #

如果想在VSCode里直接点击“运行”或“调试”时自动加载对应路径，可以用tasks.json定义运行任务，根据构建类型动态设置环境变量：

1. 在.vscode/tasks.json中添加运行任务：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Run Debug",
            "type": "shell",
            "command": "${workspaceFolder}/build/Debug/your_app.exe",
            "env": {
                "PATH": "${env:QT_DIR}\\bin;${workspaceFolder}/build/Debug/lib;${env:PATH}"
            },
            "problemMatcher": [],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        },
        {
            "label": "Run Release",
            "type": "shell",
            "command": "${workspaceFolder}/build/Release/your_app.exe",
            "env": {
                "PATH": "${env:QT_DIR}\\bin;${workspaceFolder}/build/Release/lib;${env:PATH}"
            },
            "problemMatcher": []
        }
    ]
}

2. 在VSCode的“运行和调试”面板中选择对应任务启动，或绑定快捷键到这两个任务，就能一键运行对应构建类型的程序，无需手动设置PATH。

以上方案均针对本地开发运行需求，部署时仍可按计划将DLL放到可执行文件同目录。

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