Windows Vscode如何远程连接WSL2 Ubuntu?(WSL插件:WSL: Connect to WSL using Distro)
发布时间:2026/8/22 22:01:12 作者:尧图编辑部 阅读量:1,286
)
文章目录Vscode如何远程连接WSL2 Ubuntu1. 确认 Ubuntu 正在使用 WSL22. 安装 VS Code 的 WSL 扩展3. 连接 Ubuntu4. 建议把项目放在 Ubuntu 文件系统如果 code . 无法执行Vscode如何远程连接WSL2 UbuntuVS Code 连接本机的 WSL2 Ubuntu不需要配置 SSH。使用微软官方的WSL 扩展即可。1. 确认 Ubuntu 正在使用 WSL2在 Windows PowerShell 中运行wsl-l-v应该看到类似NAME STATE VERSION Ubuntu Running 2如果VERSION是 1执行wsl--set-versionUbuntu 22. 安装 VS Code 的 WSL 扩展在 Windows 版 VS Code 中按CtrlShiftX搜索WSL安装微软发布的WSL扩展注意VS Code 主程序应安装在Windows不需要在 Ubuntu 中单独安装 Linux 版 VS Code。3. 连接 Ubuntu最方便的方法是在 Ubuntu 终端中执行cd~/projects code.我没执行成功可能vscode环境变量有点问题应该是要先安装后面的WSL插件它会在wsl2 ubuntu里安装依赖然后才可以在ubuntu里直接用code命令执行后面试了也还是不行后面终于搞清楚了是之前在wsl设置的这个appendWindowsPath导致的参考文章WSL2为什么要继承Windows的环境变量奇葩设计WSL环境变量、wsl设置、wsl配置、wsl自动挂载、interop、/etc/wsl.confappendWindowsPath为了不引入windows环境变量又能在wsl里使用code命令打开vscode我使用手动添加环境变量的方法执行echo export PATH$PATH:/mnt/c/Program Files/Microsoft VS Code/bin ~/.bashrc然后执行source ~/.bashrc第一次执行时VS Code 会自动在 Ubuntu 内安装VS Code Server。完成后VS Code 左下角应该显示WSL: Ubuntu此时VS Code 界面运行在 Windows代码、终端、Git、Python、Node.js 等运行在 Ubuntu新建终端时会直接进入 Ubuntu Bash也可以从 VS Code 连接按F1或CtrlShiftP搜索并选择WSL: Connect to WSL报错了不知道为啥难道选错了选择这个现在可以了如果安装了多个 Linux 发行版选择WSL: Connect to WSL using Distro然后选择 Ubuntu。4. 建议把项目放在 Ubuntu 文件系统推荐mkdir-p~/projectscd~/projectsgitclone仓库地址code.项目路径类似/home/arnold/projects/my-project不太建议把大型 Node.js、Python 或 Git 项目放在/mnt/c/Users/...因为跨 Windows/WSL 文件系统访问可能更慢尤其是包含大量小文件的node_modules项目。如果code .无法执行先关闭并重新打开 Ubuntu 终端然后运行whichcode code--version仍然找不到时确保安装的是 Windows 版 VS Code重新安装 VS Code安装时勾选Add to PATH执行wsl--shutdown重新打开 Ubuntu再运行code.连接成功后Python、Pylance、ESLint 等开发扩展可能需要点击Install in WSL: Ubuntu因为这些扩展需要在 Ubuntu 环境中运行。官方说明Developing in WSL