VSCode WSL2 插件完整生效配置

📅 2026/7/5 13:36:28
VSCode WSL2 插件完整生效配置
一、前置必备:安装远程核心插件(Windows 本地)1.Windows 打开 VSCode,扩展面板Ctrl+Shift+X2.搜索 Remote - WSL(微软官方)安装3.两种方式进入WSL 远程窗口(关键!普通 Windows 窗口插件不会生效)方式 1(推荐):WSL 终端进入项目目录执行code.方式 2:左下角绿色远程图标 → Connect to WSL,打开 WSL 窗口二、核心原理:两种插件安装位置(大部分人失效根源)VSCode 分本地 Windows 插件、WSL 远端 Linux 插件,分工完全不同Visual Studio Code1.本地 Local(Windows 运行)仅 UI 类插件:主题、图标、快捷键、配色,一次安装全局生效。2.远端 WSL(Linux 子系统运行,必须单独装)语言解析、编译、调试、CMake、C/C++、GitLens、Zephyr/West 插件、代码补全、语法检查。Windows 装了没用,必须在 WSL 窗口重新安装。三、在 WSL 窗口正确安装插件1.确保左下角是 WSL 标识,打开扩展面板2.搜索需要的插件(如 C/C++ Extension Pack、CMake Tools、Zephyr IDE)3.按钮显示 Install in WSL: Ubuntu,点击安装;若 Windows 本地已装,插件会灰色禁用,点云端图标一键同步全部本地插件到 WSL:Install Local Extensions in WSL: Ubuntu