首先安装WSL并配置linux发行版,如ubuntu-22.04;接着安装vscode及Remote-WSL扩展;然后通过命令面板启动“Remote-WSL: New Window”连接到WSL环境;最后在WSL中安装开发工具并配置项目路径,实现高效远程开发。

在windows系统上使用VSCode进行远程开发,结合WSL(Windows Subsystem for Linux)是一种高效且贴近生产环境的开发方式。通过VSCode的远程开发扩展,可以直接在WSL环境中编辑、运行和调试代码,享受Linux工具链的同时保留Windows的便利性。下面是如何配置VSCode + WSL进行远程开发的实用步骤。
安装WSL和Linux发行版
确保你的Windows已启用WSL功能并安装了Linux发行版:
- 以管理员身份打开PowerShell,运行:wsl –install(会默认安装Ubuntu)
- 也可手动选择发行版,如:wsl –install -d Ubuntu-22.04
- 安装完成后重启电脑,系统会提示创建用户名和密码
- 之后可通过wsl命令进入Linux环境
安装VSCode和Remote-WSL扩展
VSCode需要安装官方远程开发支持:
连接到WSL开发环境
安装完成后即可快速接入WSL:
- 按 Ctrl+Shift+P 打开命令面板
- 输入“Remote-WSL: New Window”并执行
- VSCode会启动一个连接到WSL的新窗口
- 此时左下角会显示当前连接的WSL发行版名称,如“Ubuntu”
- 打开项目文件夹时,默认路径为Linux文件系统,例如:/home/username/project
配置开发环境与常用设置
进入WSL环境后,可进行个性化和效率优化:
- 在WSL终端中安装必要的开发工具,如git、node.js、python等
- VSCode的扩展会自动推荐在WSL中安装的版本,建议在远程环境下安装语言支持插件(如python、Pylance)
- 文件修改保存即生效,Windows和WSL之间的文件互通可通过wsl$访问
- 避免在Windows侧直接编辑WSL中的文件,以防权限或性能问题
基本上就这些。配置完成后,你可以在熟悉的VSCode界面中,利用完整的Linux环境进行开发,编译、测试、调试都能原生运行。这种方式特别适合node.JS、Python、rust等跨平台项目,也能很好支持docker和CLI工具链。不复杂但容易忽略的是权限和文件系统路径问题,保持操作在WSL内部进行最稳妥。


