Windows WSL2开发环境搭建全攻略

📅 2026/7/31 21:07:53
Windows WSL2开发环境搭建全攻略
1. 开启 WSLWindows 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 22. 安装 WSL 系统WSL 功能开启后需要安装具体的 Linux 发行版。2.1 使用命令行安装可以通过命令行直接安装 Linux 系统习惯 CentOS 的朋友推荐安装 AlmaLinux-10# 列出可用的 Linux 发行版 wsl --list --online # 安装 AlmaLinux-10最新 LTS 版本 wsl --install -d AlmaLinux-102.3 初始设置安装完成后首次启动会提示# 设置用户名和密码 Enter new UNIX username: yourusername New password: Retype new password:2.4 验证安装# 查看已安装的 WSL 发行版 wsl --list --verbose - 输出示例 NAME STATE VERSION AlmaLinux-10 Running 23. VS Code 连接 WSLVisual Studio Code 可以通过 Remote - WSL 扩展在 WSL 环境中进行开发。3.1 安装 Remote - WSL 扩展打开 VS Code进入扩展市场 (CtrlShiftX)搜索 Remote - WSL点击安装3.2 连接到 WSL有几种方式连接到 WSL# 方法1在 WSL 终端中直接打开当前目录 code . # 方法2在 VS Code 中点击左下角绿色图标 选择 New WSL Window 或 Connect to WSL3.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-venv3.4 验证连接在 VS Code 终端中运行# 检查当前环境 uname -a - 输出应显示 Linux 内核信息 # 检查是否在 WSL 中 cat /proc/version - 输出应包含 Microsoft 字样4. 安装 Docker DesktopDocker Desktop 提供了在 WSL 2 中运行 Docker 的完整体验。4.1 下载 Docker Desktop访问 Docker 官网Docker Desktop: The #1 Containerization Tool for Developers | Docker下载 Windows 版本的 Docker Desktop运行安装程序4.2 安装配置在安装过程中确保勾选以下选项Install required Windows components for WSL 2Add shortcut to desktopEnable WSL 2 based engine重要4.3 配置 WSL 2 集成安装完成后打开 Docker Desktop 设置进入 Settings → Resources → WSL Integration启用 Enable integration with my default WSL distro选择要集成的 WSL 发行版如 AlmaLinux-10点击 Apply Restart4.4 验证 Docker 安装在 WSL 终端中运行# 检查 Docker 版本 docker --version - 输出示例Docker version 24.0.7, build afdd53b # 运行测试容器 docker run hello-world # 检查 Docker 服务状态 sudo service docker status4.5 常用 Docker 命令# 查看 Docker 信息 docker info # 列出所有容器 docker ps -a # 列出所有镜像 docker images # 构建镜像 docker build -t myapp . # 运行容器 docker run -d -p 8080:80 --name mycontainer myapp4.6 配置 Docker ComposeDocker 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: example5. 启用 AI Agent当前 AI 技术为开发工作带来了极大的便利不过需要注意的是使用 AI 服务通常会产生 token 费用。您可以尝试使用 OpenCode 的免费模型来体验 AI 编程助手。在 WSL 命令行中输入以下命令即可安装 OpenCodecurl -fsSL https://opencode.ai/install | bash此外VS Code 中也有 OpenCode 插件可以方便地集成使用。总结通过以上五个步骤您已经成功搭建了一个功能完整的 WSL 2 开发环境为现代软件开发提供了强大的基础平台开启 WSL 功能在 Windows 中启用 Linux 子系统为跨平台开发奠定基础。安装并配置 Linux 发行版选择适合的 Linux 发行版如 AlmaLinux-10完成系统初始化和验证。连接 VS Code 进行远程开发通过 Remote - WSL 扩展实现无缝的代码编辑、调试和项目管理体验。安装 Docker Desktop 并集成到 WSL 2获得完整的容器化开发能力支持 Docker 和 Docker Compose。集成 AI 开发助手通过 OpenCode 等工具利用 AI 技术提升编码效率和代码质量。这个环境融合了 Windows 的易用性和 Linux 的开发能力为您提供了原生 Linux 开发体验在 WSL 中直接运行 Linux 工具链和命令行工具。无缝的容器化支持Docker 与 WSL 2 深度集成性能接近原生 Linux。高效的开发工作流VS Code 远程开发提供完整的 IDE 功能。现代化的开发工具链从传统开发到云原生、AI 辅助开发的全面支持。现在您可以在这个统一的环境中开展 Web 开发、后端服务、容器化应用、云原生项目等各种开发工作享受 Windows 桌面体验的同时获得 Linux 的开发能力。