从 VSCode 使用 WSL（Windows 子系统）

WSL（Windows Subsystem for Linux）允许在 Windows 上运行 Linux 环境。

安装 WSL

方法一：一键安装（推荐，Windows 10 2004+）

# 以管理员身份运行 PowerShell
wsl --install

这将自动启用 WSL 功能、安装 Linux 内核并安装 Ubuntu。

方法二：手动安装

# 1. 启用 WSL 功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 2. 启用虚拟机平台
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 3. 重启电脑

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

# 5. 安装 Ubuntu（从 Microsoft Store 或手动）
wsl --install -d Ubuntu

方法三：离线安装

1. 下载 Linux 发行版：https://docs.microsoft.com/zh-cn/windows/wsl/install-manual
2. 使用 PowerShell 提取 .appx 包：

Rename-Item .\Ubuntu.appx .\Ubuntu.zip
Expand-Archive .\Ubuntu.zip .\Ubuntu

3. 运行 ubuntu.exe 完成初始化设置

VSCode 集成

安装扩展

1. 在 VSCode 中安装 WSL 扩展（Microsoft 官方）
2. 安装后左下角会出现绿色图标

连接 WSL

# 方法1: 在 WSL 终端中打开 VSCode
code .

# 方法2: 在 VSCode 中连接
# 点击左下角绿色图标 → Remote-WSL: New Window

# 方法3: 命令面板
# Ctrl+Shift+P → Remote-WSL: New Window

WSL 常用命令

# 查看已安装的发行版
wsl --list --verbose

# 启动默认发行版
wsl

# 启动指定发行版
wsl -d Ubuntu

# 关闭 WSL
wsl --shutdown

# 设置默认发行版
wsl --set-default Ubuntu

# 设置 WSL 版本
wsl --set-version Ubuntu 2

# 导出发行版
wsl --export Ubuntu D:\backup\ubuntu.tar

# 导入发行版
wsl --import Ubuntu D:\WSL\Ubuntu D:\backup\ubuntu.tar

VSCode Remote 开发

连接 WSL 后，VSCode 的终端、文件系统、扩展都运行在 Linux 环境中：

• 终端是 Linux bash
• 文件路径是 Linux 格式（/home/...）
• Git、Node.js 等工具使用 Linux 版本
• 扩展可以在 WSL 侧单独安装

注意：Windows 侧的文件可以通过 /mnt/c/ 访问，但性能较低。建议将项目放在 WSL 文件系统中。