Windows WSL2开发环境搭建全攻略

1. 开启 WSL

Windows Subsystem for Linux (WSL) 允许您在 Windows 上直接运行 Linux 环境。以下是开启 WSL 的详细步骤：

1.1 系统要求

• Windows 10 版本 2004 及更高版本（内部版本 19041 及更高版本）或 Windows 11
• 启用虚拟化功能（在 BIOS/UEFI 中）
• 至少 4GB 内存（推荐 8GB 或更多）

1.2 开启 WSL 功能

通过 PowerShell（管理员身份）运行以下命令：

# 启用 WSL 功能 dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart # 启用虚拟机平台功能 dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

执行完成后，重启计算机使更改生效。

1.3 设置 WSL 2 为默认版本

# 将 WSL 2 设置为默认版本 wsl --set-default-version 2

2. 安装 WSL 系统

WSL 功能开启后，需要安装具体的 Linux 发行版。

2.1 使用命令行安装

可以通过命令行直接安装 Linux 系统，习惯 CentOS 的朋友推荐安装 AlmaLinux-10：

# 列出可用的 Linux 发行版 wsl --list --online # 安装 AlmaLinux-10（最新 LTS 版本） wsl --install -d AlmaLinux-10

2.3 初始设置

安装完成后，首次启动会提示：

# 设置用户名和密码 Enter new UNIX username: yourusername New password: Retype new password:

2.4 验证安装

# 查看已安装的 WSL 发行版 wsl --list --verbose - 输出示例： NAME STATE VERSION AlmaLinux-10 Running 2

3. VS Code 连接 WSL

Visual Studio Code 可以通过 Remote - WSL 扩展在 WSL 环境中进行开发。

3.1 安装 Remote - WSL 扩展

1. 打开 VS Code
2. 进入扩展市场 (Ctrl+Shift+X)
3. 搜索 "Remote - WSL"
4. 点击安装

3.2 连接到 WSL

有几种方式连接到 WSL：

# 方法1：在 WSL 终端中直接打开当前目录 code . # 方法2：在 VS Code 中点击左下角绿色图标 选择 "New WSL Window" 或 "Connect to WSL"

3.3 配置开发环境

在 WSL 中安装必要的开发工具：

# 更新包列表 sudo dnf update # 安装常用开发工具 sudo dnf install -y git curl wget build-essential # 安装 Node.js（示例） curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo dnf install -y nodejs # 安装 Python sudo dnf install -y python3 python3-pip python3-venv

3.4 验证连接

在 VS Code 终端中运行：

# 检查当前环境 uname -a - 输出应显示 Linux 内核信息 # 检查是否在 WSL 中 cat /proc/version - 输出应包含 "Microsoft" 字样

4. 安装 Docker Desktop

Docker Desktop 提供了在 WSL 2 中运行 Docker 的完整体验。

4.1 下载 Docker Desktop

1. 访问 Docker 官网：Docker Desktop: The #1 Containerization Tool for Developers | Docker
2. 下载 Windows 版本的 Docker Desktop
3. 运行安装程序

4.2 安装配置

在安装过程中，确保勾选以下选项：

• Install required Windows components for WSL 2
• Add shortcut to desktop
• Enable WSL 2 based engine（重要）

4.3 配置 WSL 2 集成

安装完成后，打开 Docker Desktop 设置：

1. 进入 Settings → Resources → WSL Integration
2. 启用 "Enable integration with my default WSL distro"
3. 选择要集成的 WSL 发行版（如 AlmaLinux-10）
4. 点击 "Apply & Restart"

4.4 验证 Docker 安装

在 WSL 终端中运行：

# 检查 Docker 版本 docker --version - 输出示例：Docker version 24.0.7, build afdd53b # 运行测试容器 docker run hello-world # 检查 Docker 服务状态 sudo service docker status

4.5 常用 Docker 命令

# 查看 Docker 信息 docker info # 列出所有容器 docker ps -a # 列出所有镜像 docker images # 构建镜像 docker build -t myapp . # 运行容器 docker run -d -p 8080:80 --name mycontainer myapp

4.6 配置 Docker Compose

Docker Desktop 已包含 Docker Compose，验证安装：

# 检查 Docker Compose 版本 docker-compose --version # 或使用新版本命令 docker compose version

创建简单的 docker-compose.yml 文件：

version: '3.8' services: web: image: nginx:alpine ports: - "80:80" volumes: - ./html:/usr/share/nginx/html db: image: postgres:15 environment: POSTGRES_PASSWORD: example

5. 启用 AI Agent

当前 AI 技术为开发工作带来了极大的便利，不过需要注意的是，使用 AI 服务通常会产生 token 费用。

您可以尝试使用 OpenCode 的免费模型来体验 AI 编程助手。

在 WSL 命令行中输入以下命令即可安装 OpenCode：

curl -fsSL https://opencode.ai/install | bash

此外，VS Code 中也有 OpenCode 插件，可以方便地集成使用。

总结

通过以上五个步骤，您已经成功搭建了一个功能完整的 WSL 2 开发环境，为现代软件开发提供了强大的基础平台：

1. 开启 WSL 功能：在 Windows 中启用 Linux 子系统，为跨平台开发奠定基础。
2. 安装并配置 Linux 发行版：选择适合的 Linux 发行版（如 AlmaLinux-10），完成系统初始化和验证。
3. 连接 VS Code 进行远程开发：通过 Remote - WSL 扩展实现无缝的代码编辑、调试和项目管理体验。
4. 安装 Docker Desktop 并集成到 WSL 2：获得完整的容器化开发能力，支持 Docker 和 Docker Compose。
5. 集成 AI 开发助手：通过 OpenCode 等工具，利用 AI 技术提升编码效率和代码质量。

这个环境融合了 Windows 的易用性和 Linux 的开发能力，为您提供了：

• 原生 Linux 开发体验：在 WSL 中直接运行 Linux 工具链和命令行工具。
• 无缝的容器化支持：Docker 与 WSL 2 深度集成，性能接近原生 Linux。
• 高效的开发工作流：VS Code 远程开发提供完整的 IDE 功能。
• 现代化的开发工具链：从传统开发到云原生、AI 辅助开发的全面支持。

现在您可以在这个统一的环境中开展 Web 开发、后端服务、容器化应用、云原生项目等各种开发工作，享受 Windows 桌面体验的同时获得 Linux 的开发能力。