Windows 零基础开发环境配置

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 (开启)。

1. 以管理员身份打开 PowerShell#

• 操作：右键点击”开始”按钮 → 选择 Windows PowerShell (管理员) 或 终端(管理员)。

• 含义：Administrator (管理员) 权限允许软件修改系统底层设置。

2. 执行一键安装命令#

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

1
wsl --install

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

3. 重启电脑#

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

4. 设置 Linux 用户名和密码#

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

• Enter new UNIX username: 输入一个英文名（如 devuser），回车。

• Enter new UNIX password: 输入密码（注意：输入时屏幕不会显示星号，输完直接回车），再输入一次确认。

• 含义：这是你在 Linux 系统中的独立账号，与 Windows 账号无关。

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 编辑框中，粘贴以下代码（替换原有内容）：

   1
   {
   2
     "registry-mirrors": [
   3
       "https://docker.m.daocloud.io",
   4
       "https://huecker.io",
   5
       "https://dockerhub.timeweb.cloud"
   6
     ]
   7
   }

   • 含义：registry-mirrors 告诉 Docker 去这些国内的服务器找镜像，速度会快很多。

4. 点击右下角 Apply & restart (应用并重启)。

4. 验证 Docker 是否成功#

打开 PowerShell，输入：

1
docker run hello-world

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

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. 创建项目文件夹#

在终端中输入：

1
mkdir -p ~/projects
2
code ~/projects

• 含义：

  • mkdir -p ~/projects：在 Linux 主目录下创建一个名为 projects 的文件夹。

  • code ~/projects：用 VS Code 远程打开这个 Linux 文件夹。此时 VS Code 左下角应显示 “WSL: Ubuntu”。

3. 运行 Nginx 测试网页#

在 VS Code 的终端中输入：

1
docker run -d -p 8080:80 nginx

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

4. 浏览器验证#

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

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