WSL、VS Code、Docker Desktop 安装与配置指南

1. 第一步：安装 WSL (Windows Subsystem for Linux)#

安装逻辑：WSL 是底层基础环境，Docker Desktop 依赖 WSL 2 后端运行，因此必须最先安装。

安装到非系统盘：

以管理员身份打开 PowerShell，直接使用 --location 参数指定安装路径即可一步到位，无需后期迁移：

1
wsl --install -d Ubuntu --location "D:\WSL\Ubuntu"

（注：将 D:\WSL\Ubuntu 替换为你实际想要安装的目标路径。安装完成后首次启动需设置用户名和密码）

2. 第二步：安装 VS Code#

安装逻辑：作为代码编辑器，它需要连接 WSL 进行开发，建议在 WSL 之后安装。

安装到非系统盘：

• 常规安装版：运行官方安装包，在”选择安装路径”步骤时，点击”浏览”并选择非系统盘目录（如 D:\VSCode）。注意：安装路径必须为纯英文，禁止包含中文或空格，否则会导致后续插件安装失败。
• 便携版 (Portable Mode)：如果你希望完全不写入注册表、所有配置和插件都保存在本地文件夹，可以下载 Windows ZIP 压缩包，解压到非系统盘后，在解压目录内手动创建一个名为 data 的文件夹，后续双击 Code.exe 启动即可。

3. 第三步：安装 Docker Desktop#

安装逻辑：Docker 需要依赖已安装好的 WSL 2 环境，因此必须放在最后安装。

安装到非系统盘：

Docker Desktop 默认会安装在 C 盘，需通过命令行指定路径。

1. 从官网下载 Docker Desktop Installer.exe 并移至易于访问的位置（如 D:\）。
2. 以管理员身份打开 PowerShell，运行以下命令：

1
& "D:\Docker Desktop Installer.exe" install --installation-dir="D:\Docker"

（注：--installation-dir 指定的目标目录不能与安装包所在的目录相同，否则会报错。看到 Installation succeeded 即代表安装成功）

额外建议#

在安装完成后，为了保证开发性能，建议将你的项目代码文件存储在 WSL 2 文件系统（如 /home/yourname/projects/）中，而不是 Windows 文件系统（如 C:\ 或 D:\）中。跨操作系统的文件共享访问会明显拖慢 Docker 和编译工具的运行速度。

第一步：给 VS Code 装”插件” (Plugin)#

插件 (Plugin)：你可以把它理解为”外挂”或者”扩展功能”。VS Code 本身只是个编辑器，装上插件它才能和 WSL 里的 Linux 系统对话。

1. 打开你刚装好的 VS Code。
2. 看屏幕最左边那一排图标，找到长得像四个小方块拼在一起的图标（这叫 Extensions，意思是”扩展/插件”），点一下它。
3. 在顶部的搜索框里，输入 WSL。
4. 找到第一个，名字叫 WSL，作者是 Microsoft（微软官方出的），点击蓝色的 Install（安装）按钮。

第二步：让 VS Code 连上你的 Linux 系统#

装好插件后，我们要告诉 VS Code 去 WSL 里面干活。

1. 看 VS Code 界面的左下角，有一个像 >< 这样的绿色小图标（这叫 Remote，意思是”远程连接”），点一下它。
2. 在屏幕最上方弹出的菜单里，选择 Connect to WSL（连接到 WSL）。
3. 接着会弹出一个列表，里面是你刚才装的 Linux 系统（比如 Ubuntu），点一下它。

第三步：见证奇迹的时刻#

点完之后，你会看到 VS Code 稍微闪一下，然后左下角的图标旁边会多出一行小绿字，写着类似 WSL: Ubuntu。

这就说明你已经成功连上了！

接下来，你只需要点击左上角的 File（文件） → Open Folder（打开文件夹），这时候弹出的窗口就是 Linux 里面的文件夹了。你可以直接在里面新建代码文件、写代码，所有的操作都在 Linux 环境下进行，速度飞快！