### 如何在 Visual Studio Code 中使用 WSL 连接到 Docker 容器 #### 配置 Windows Subsystem for Linux (WSL) 为了使 Docker 能够与 WSL 无缝协作，需确认已安装并配置好 WSL 和 Ubuntu 实例。当启动 Docker Desktop 后，在 Windows 任务栏中会显示新的 Docker 图标[^3]。右键点击此图标并选择“WSL Tech Preview”，这一步骤将触发 Docker WSL2 的安装向导。 #### 设置 Docker Desktop 支持 WSL 2 确保 Docker Desktop 正常运行，并且其设置允许支持 WSL 2 版本的 Linux 发行版。如果一切正常，则可以继续下一步；如果有缺失的前提条件，按照提示完成必要的调整后再尝试连接操作。 #### 使用 VS Code 访问基于 WSL 的 Docker 环境 一旦上述准备工作就绪，可以通过以下方式让 VS Code 接入到由 WSL 提供支撑作用下的 Docker： 1. 打开命令面板 (`Ctrl+Shift+P`) 并输入 `Remote-WSL: New Window` 来创建一个新的窗口来访问 WSL 文件系统。 2. 在新打开的 VS Code 窗口中，利用扩展市场找到并安装官方提供的 “Dev Containers” 插件以及其它可能需要用到的相关插件如 Python 或者 Node.js 开发套件等。 3. 创建项目文件夹并在其中初始化 Git 库（可选），接着通过 `.devcontainer/devcontainer.json` 文件定义所需的开发容器镜像和其他依赖项。 4. 对于更复杂的场景，比如需要自定义构建过程或者指定额外的服务时，可以在同一目录下添加 `Dockerfile` 和 `docker-compose.yml` 文件来进行详细的描述。 5. 若要启用调试模式，可在项目的根目录下建立或编辑 `.vscode/launch.json` 文件加入相应的配置选项以满足不同编程语言的需求[^4]。 ```json { "version": "0.2.0", "configurations": [ { "name": "(gdb) Launch", "type": "cppdbg", "request": "launch", "program": "${workspaceFolder}/build/main", "args": [], "stopAtEntry": false, "cwd": "${workspaceFolder}", "environment": [], "externalConsole": true, "MIMode": "gdb", "setupCommands": [ { "description": "Enable pretty-printing for gdb", "text": "-enable-pretty-printing", "ignoreFailures": true } ], "preLaunchTask": "C/C++: g++.exe build active file", "miDebuggerPath": "/usr/bin/gdb" } ] } ``` 以上步骤完成后，即可实现从 VS Code 经过 WSL 到达 Docker 容器内部的工作流程，从而享受高效的跨平台开发体验。