vscode 打开 WSL 里面的文件夹项目
掌握 VSCode 连接 WSL 开发的配置方法
能直接用 VSCode 打开 WSL 里的项目文件夹
理解 WSL 开发模式的优势与工作原理
核心讲解
VSCode + WSL 是 Windows 下 Linux 开发的黄金组合:VSCode 界面在 Windows,代码运行、编译、调试都在 WSL 的 Linux 环境里,体验和原生 Linux 开发几乎没有区别。
(1)核心原理
VSCode 通过Remote - WSL插件,远程连接到 WSL 里的 VSCode 服务端,前端 UI 在 Windows,后端运行在 Linux,文件、代码、终端都在 WSL 里。
(2)准备工作
Windows 安装 VSCode
安装插件:Remote - WSL(微软官方插件)
WSL 里已经安装好对应开发环境(Python/Node/Go 等)
(3)三种打开方式
WSL 终端里直接打开 进入项目目录,执行
code .,会自动启动 Windows 的 VSCode,连接 WSL 并打开当前目录。 最常用、最方便的方式。VSCode 里远程连接 打开 VSCode,左下角点击绿色远程按钮 → 选择「Connect to WSL」 → 选择发行版 → 打开文件夹。
右键菜单打开 文件夹右键,选择「通过 VS Code 打开」,如果是 WSL 目录会自动切换远程模式。
(4)使用特点
所有插件、配置和本地 VSCode 通用
终端默认就是 WSL 的 Linux 终端
代码补全、调试、运行都在 Linux 环境
性能接近原生,几乎感受不到是远程
操作示例
# ===== WSL终端打开项目 =====
# 1. 进入项目目录
cd ~/my_project
# 2. 用VSCode打开当前目录
code .
# 会自动唤起Windows的VSCode,左下角显示 WSL: Ubuntu-22.04
# 就是连接成功了
# ===== VSCode内操作 =====
# 1. 打开VSCode,按 Ctrl+Shift+P
# 2. 输入 WSL: Connect to WSL
# 3. 选择发行版,等待连接
# 4. 菜单:文件→打开文件夹,选择WSL里的项目路径
常见误区
没装插件直接 code .:必须先装 Remote - WSL 插件,否则 code 命令不生效
把项目放 Windows 盘里用 WSL 运行:项目一定要放在 WSL 的 Linux 文件系统里(/home/ 下),放 /mnt 下性能会非常差
插件还要在 WSL 里装:常用插件会自动同步到 WSL 端,部分需要在远程安装
连接失败:先确认 WSL 能正常启动,网络没问题,重启 WSL 一般能解决
课后练习
在 VSCode 中安装 Remote - WSL 插件
在 WSL 里创建一个项目文件夹,用 VSCode 打开
验证 VSCode 的终端是 Linux 环境,运行 Linux 命令

