如何在VSCode中设置cwd（当前工作目录）以调试运行C++程序

云原生阿岚

2026-10-13

VSCode C++调试工作目录配置教程

前置条件

确保已安装微软官方的C/C++扩展，且VSCode打开的是你的C++项目根文件夹（不可单独打开单个.cpp文件，否则配置无法生效）。

配置步骤

打开调试配置文件

按下快捷键Ctrl+Shift+D（macOS系统为Cmd+Shift+D）打开调试侧边栏
点击侧边栏顶部的齿轮状设置图标，在弹出的环境选项中选择对应调试器（Windows选「C++ Windows」，macOS/Linux选「C++ GDB/LLDB」），系统会自动在项目根目录生成.vscode/launch.json配置文件

打开生成的launch.json文件，找到configurations数组下对应调试配置的cwd字段，该字段的取值就是调试运行时的工作目录
默认取值为"${workspaceFolder}"，即当前打开的项目根目录，你可以根据需求替换为目标路径：
- 用项目内相对路径：比如要设为项目下的build/bin目录，可写为"${workspaceFolder}/build/bin"
- 用全局绝对路径：Windows下写为"C:/Users/你的用户名/Desktop/test_workdir"，macOS/Linux下写为"/home/你的用户名/test_workdir"
如果配置中没有cwd字段，手动新增即可

配置示例

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "g++ 调试活动文件",
            "type": "cppdbg",
            "request": "launch",
            "program": "${fileDirname}/${fileBasenameNoExtension}",
            "args": [],
            "stopAtEntry": false,
            // 工作目录配置项，此处设为项目下的debug目录
            "cwd": "${workspaceFolder}/debug",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "miDebuggerPath": "/usr/bin/gdb"
        }
    ]
}