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 的开发能力。
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 的开发能力。
