Skip to content

WSL 默认发行版配置指南（适用于 VS Code）

本文介绍如何在 Windows 系统中设置和使用默认的 WSL（Windows Subsystem for Linux）发行版，尤其是如何在 Visual Studio Code (VS Code) 中进行对应配置。

🛠️ 设置默认 WSL 发行版

  1. 查看已安装的 WSL 发行版 打开 PowerShell 或命令提示符，输入以下命令：
wsl --list --verbose

输出示例：

  NAME      STATE           VERSION
* Ubuntu    Running         2
  Debian    Stopped         2

带 * 星号的即为当前默认发行版。

  1. 设置默认发行版 执行如下命令，将 <发行版名称> 替换为实际名称（如 Debian）：
wsl --set-default Debian

设置成功后，打开终端或 VS Code 的默认 WSL 会话即连接该发行版。

💡 VS Code 中连接特定 WSL 发行版

如需在 VS Code 中连接非默认发行版，可按如下方式操作：

  1. 安装 Remote - WSL 插件 在 VS Code 扩展市场中搜索并安装 Remote - WSL 插件。

  2. 使用命令面板选择发行版连接

  3. 使用快捷键 Ctrl+Shift+P（或 F1）打开命令面板；

  4. 输入 WSL: Connect to WSL using Distro... 并选择；
  5. 从弹出的发行版列表中选择所需发行版。

此功能无需更改系统默认设置即可在 VS Code 中切换发行版。 📚 来源：Worktile、vscode.js.cn

🔄 常用 WSL 命令

命令 说明
wsl --list --verbose 查看当前已安装发行版及默认项
wsl --set-default <发行版名称> 设置默认发行版
wsl --list --online 查看可安装的发行版
wsl --install -d <发行版名称> 安装指定发行版
wsl --set-default-version 2 设置默认 WSL 版本为 WSL 2

✅ 总结

通过设置默认 WSL 发行版，您可以统一终端和 VS Code 的 Linux 环境，提高开发效率；同时，VS Code 的 Remote - WSL 插件也支持按需灵活连接不同的发行版，满足多环境开发需求。

Ref

https://worktile.com/kb/ask/550934.html https://vscode.js.cn/docs/remote/wsl https://learn.microsoft.com/en-us/windows/wsl/basic-commands https://docs.microsoft.com/zh-cn/windows/wsl/ https://github.com/microsoft/WSL