WSL Ubuntu 中 VS Code 插件安装指南
首先理解 WSL
WSL (Windows Subsystem for Linux) 允许你在 Windows 中运行 Linux 环境(如 Ubuntu),而 VS Code 可以通过“远程开发”功能连接到 WSL 中的 Ubuntu 环境。
两种安装场景
1.在 WSL 内部安装 VS Code 服务器
当你第一次在 WSL 的 Ubuntu 终端输入code .时,VS Code 会自动:
在 WSL 中安装一个小型的 VS Code 服务器
在 Windows 的 VS Code 中安装“Remote - WSL”扩展
2.插件安装的两种位置
这是关键区别:
a) 安装在 Windows 端(本地)
插件安装在 Windows 系统的 VS Code 中
适合:UI/主题类、通用工具类插件
例如:主题美化、图标主题、某些通用工具
b) 安装在 WSL: Ubuntu 端(远程)
插件实际安装在 WSL 的 Ubuntu 环境中
适合:语言支持、编译器、调试器、依赖 Ubuntu 环境的功能
例如:Python 扩展、C++ 工具链、Node.js 相关扩展
如何识别和选择
在 VS Code 扩展市场中,你会看到:
Python 扩展 └──安装按钮显示为【在 WSL: Ubuntu 中安装】为什么需要区分安装位置
安装在 WSL 中的原因:
环境一致性:Python/Node.js 等扩展需要访问 WSL 中的解释器、包管理器
路径解析:正确处理 Linux 文件路径(如
/home/username/)工具链访问:直接使用 WSL 中的编译器、调试器
依赖管理:能正确识别 WSL 中安装的依赖包
实际工作流程
在 Windows 打开 VS Code
点击左下角绿色图标 > 选择“连接到 WSL”
VS Code 界面现在“附加”到 WSL 环境
安装插件时,VS Code 智能建议安装位置
需要 WSL 环境支持的插件会自动安装在 Ubuntu 中
查看已安装位置
在扩展面板中,已安装的插件会显示:
🌍 地球图标 = 本地(Windows)
🔌 插头图标 = 远程(WSL)
管理技巧
大部分开发相关扩展建议安装在 WSL 端
界面美化类扩展安装在本地 Windows 端
可以手动将扩展从一端移动到另一端(右键点击扩展)
这样设计的好处是:你可以在 Windows 享受 VS Code 的良好 UI 性能,同时在 WSL 中获得完整的 Linux 开发环境支持。