VSCode运行CMake项目时PATH被修改，如何禁用该行为？

核心原因 #

VSCode的C++/CMake扩展会自动注入编译环境相关的PATH路径（比如Windows SDK、VS工具链路径），并且这些路径会被放在全局PATH的前面，导致你的应用优先找到Windows SDK里的dxcompiler.dll，而非Vulkan SDK版本。

可行解决方案 #

方案1：在launch.json中强制指定PATH #

打开.vscode/launch.json，在对应的调试配置项里添加environment字段，把Vulkan SDK的Bin路径放在PATH最前端：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "C++ Launch",
            "type": "cppvsdbg",
            "request": "launch",
            "program": "${workspaceFolder}/build/your_app.exe",
            "args": [],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [
                {
                    "name": "PATH",
                    "value": "C:\\VulkanSDK\\1.3.239.0\\Bin;${env:PATH}"
                }
            ],
            "externalConsole": false
        }
    ]
}

这样会强制让应用优先从Vulkan SDK目录加载dll，覆盖VSCode注入的路径顺序。

方案2：在tasks.json中配置运行环境（若通过任务启动程序） #

如果是通过tasks.json运行程序，在任务的options.env中设置PATH：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Run App",
            "type": "shell",
            "command": "${workspaceFolder}/build/your_app.exe",
            "args": [],
            "options": {
                "env": {
                    "PATH": "C:\\VulkanSDK\\1.3.239.0\\Bin;${env:PATH}"
                }
            },
            "problemMatcher": []
        }
    ]
}

方案3：CMake中复制dll到输出目录（最稳妥） #

直接在CMakeLists.txt里添加指令，把Vulkan SDK的dxcompiler.dll复制到可执行文件的输出目录，应用会优先加载同目录下的dll，完全不依赖PATH：

# 定位Vulkan SDK路径
find_package(Vulkan REQUIRED)
# 编译后自动复制dxcompiler.dll到输出目录
add_custom_command(TARGET your_app POST_BUILD
    COMMAND ${CMAKE_COMMAND} -E copy_if_different
        "${Vulkan_BINARIES_DIR}/dxcompiler.dll"
        $<TARGET_FILE_DIR:your_app>
)

该方法无需修改VSCode配置，跨环境运行也不会出问题，推荐使用。

额外说明 #

VSCode自动添加工具链路径的行为，是C++扩展为确保编译环境正常工作的默认逻辑，目前没有直接开关可以完全禁用。但通过上述方案，均可绕开该问题，保证加载正确的dll版本。

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