wsl vscode docker debug

### 配置WSL环境下VSCode调试Docker容器 #### 一、安装并配置Docker 为了能够在WSL环境中顺利使用Docker，需先完成Docker的安装。对于Windows用户来说，推荐通过官方渠道下载适用于Windows系统的Docker Desktop版本[^2]。安装过程中会自动设置好与WSL2之间的交互支持。 确保已将当前用户名添加到docker用户组以便无需sudo即可操作docker命令，在Ubuntu下可通过`sudo usermod -aG docker $USER`实现这一点。 #### 二、准备Docker镜像及容器 创建适合开发需求的基础镜像文件（如Dockerfile），其中应包含编译工具链以及必要的依赖库。之后利用此Dockerfile来构建自定义镜像，并启动相应的容器实例用于后续测试或部署工作。 针对C++项目而言，可以在Dockerfile中指定GCC或其他所需编译器作为基础环境的一部分[^1]。 #### 三、安装Visual Studio Code及其扩展包 前往微软应用商店获取最新版Visual Studio Code编辑器；接着打开软件内部市场搜索栏输入关键词“Remote - Containers”，找到由Microsoft官方维护的相关远程开发插件集进行安装[^3]。 该套件允许开发者直接连接至正在运行中的Linux容器内执行代码编写、终端控制台互动等功能，极大地方便了跨平台项目的协作流程管理。 #### 四、配置launch.json以启用调试功能 在目标工程目录下的`.vscode`文件夹里新建名为`launch.json`的JSON格式文档，按照如下模板填写相应字段： ```json { "version": "0.2.0", "configurations": [ { "name": "(gdb) Launch inside WSL Docker Container", "type": "cppdbg", "request": "launch", "program": "${workspaceFolder}/app", "args": [], "stopAtEntry": false, "cwd": "/app", "environment": [], "externalConsole": false, "MIMode": "gdb", "setupCommands": [ { "description": "Enable pretty-printing for gdb", "text": "-enable-pretty-printing", "ignoreFailures": true } ], "preLaunchTask": "Build Inside Docker", "miDebuggerPath": "/usr/bin/gdb", "containerId": "<Your Running Container ID>", "internalConsoleOptions": "openOnSessionStart" } ] } ``` 上述配置项中特别注意要替换掉`<Your Running Container ID>`部分为实际使用的容器ID号，可以通过宿主机上的`docker ps`查看获得。另外还需定义一个预启动任务用来提前准备好待测可执行文件，具体做法是在同一级路径新增tasks.json文件描述编译过程。 #### 五、验证效果 当一切准备工作完成后就可以尝试点击左侧边栏绿色箭头按钮开启一次完整的编译加断点单步跟踪体验啦！