Windows 零基础开发环境配置清单 (WSL + Docker + VS Code)

第一阶段：准备工作与系统开启

1. 确认系统版本

确保你的电脑是 Windows 10 (版本 2004 及以上) 或 Windows 11。

• 查看方法：按 Win + R，输入 winver 回车，查看版本号。

2. 开启虚拟化功能

WSL 和 Docker 需要电脑的 CPU 虚拟化支持。

• 操作：重启电脑，进入 BIOS/UEFI 设置（通常开机时按 F2、Del 或 F12），找到 Virtualization Technology (虚拟化技术) 或 Intel VT-x / AMD-V，将其设置为 Enabled (开启)。

第二阶段：安装 WSL (Windows Subsystem for Linux)

1. 以管理员身份打开 PowerShell

• 操作：右键点击"开始"按钮 → 选择 Windows PowerShell (管理员) 或 终端(管理员)。
• 含义：Administrator (管理员) 权限允许软件修改系统底层设置。

2. 执行一键安装命令

在弹出的蓝色窗口中输入以下命令并回车：

wsl --install

• 含义：该命令会自动下载并安装 Ubuntu Linux 发行版以及所需的虚拟化组件。

3. 重启电脑

• 注意：安装完成后，必须手动重启电脑才能使虚拟化组件生效。

4. 设置 Linux 用户名和密码

重启后，系统会自动弹出一个黑色窗口（Ubuntu）。

• Enter new UNIX username: 输入一个英文名（如 devuser），回车。
• Enter new UNIX password: 输入密码（注意：输入时屏幕不会显示星号，输完直接回车），再输入一次确认。
• 含义：这是你在 Linux 系统中的独立账号，与 Windows 账号无关。

第三阶段：安装与配置 Docker Desktop

1. 下载安装包

访问 Docker 官网下载 Docker Desktop for Windows 并安装。

• 建议：安装过程中勾选 Use WSL 2 instead of Hyper-V (使用 WSL 2 代替 Hyper-V)，以获得最佳性能。

2. 启动 Docker Desktop

安装完成后，在开始菜单搜索并打开 Docker Desktop。

• 等待：首次启动较慢，直到左下角显示绿色圆点及 “Engine running” (引擎运行中)。

3. 配置国内镜像加速器 (解决下载慢问题)

由于 Docker Hub 在国外，国内拉取镜像极慢，需配置加速源。

1. 点击 Docker Desktop 右上角的齿轮图标 → Settings (设置)。
2. 左侧选择 Resources (资源) → Docker Engine (Docker 引擎)。
3. 在右侧 JSON 编辑框中，粘贴以下代码（替换原有内容）：

   {
     "registry-mirrors": [
       "https://docker.m.daocloud.io",
       "https://huecker.io",
       "https://dockerhub.timeweb.cloud"
     ]
   }

   • 含义：registry-mirrors 告诉 Docker 去这些国内的服务器找镜像，速度会快很多。
4. 点击右下角 Apply & restart (应用并重启)。

4. 验证 Docker 是否成功

打开 PowerShell，输入：

docker run hello-world

如果看到 “Hello from Docker!” 字样，说明安装成功。

第四阶段：安装开发工具 VS Code

1. 下载并安装 Visual Studio Code

前往微软官网下载并安装 Visual Studio Code (简称 VS Code)。

2. 安装 WSL 插件

1. 打开 VS Code。
2. 点击左侧边栏的"四个方块"图标 (Extensions，扩展)。
3. 搜索 WSL。
4. 找到微软官方发布的 WSL 插件，点击 Install (安装)。

• 含义：该插件让 VS Code 能够直接连接到 WSL 里的 Linux 系统进行写代码。

第五阶段：建立第一个项目并测试

1. 进入 Linux 环境

在 VS Code 中，按下快捷键 Ctrl + Shift + ~ 打开终端。

• 确认：如果终端前缀显示为 user@DESKTOP:~$，说明你已进入 Linux 环境。

2. 创建项目文件夹

在终端中输入：

mkdir -p ~/projects
code ~/projects

• 含义：
  • mkdir -p ~/projects：在 Linux 主目录下创建一个名为 projects 的文件夹。
  • code ~/projects：用 VS Code 远程打开这个 Linux 文件夹。此时 VS Code 左下角应显示 “WSL: Ubuntu”。

3. 运行 Nginx 测试网页

在 VS Code 的终端中输入：

docker run -d -p 8080:80 nginx

• 含义：启动一个 Nginx 网页服务器，并将其端口映射到你电脑的 8080 端口。

4. 浏览器验证

打开 Chrome 或 Edge 浏览器，访问： http://localhost:8080

如果看到 “Welcome to nginx!” 页面，恭喜你！你的本机开发环境已全部配置完成。

常见问题排查 (FAQ)

• 开发环境搭建

• Windows
• WSL
• Docker
• VS Code
• Ubuntu
• Linux