首先安装WSL2与ubuntu，再安装vscode及Remote-WSL扩展，通过命令面板连接WSL2，在linux环境中配置开发工具与项目文件，利用VSCode实现编辑、运行、调试一体化，充分发挥windows与Linux协作优势。

在Windows系统上进行Linux环境开发，WSL2（Windows Subsystem for Linux 2）结合VSCode提供了近乎原生的开发体验。通过VSCode远程开发功能，可以直接在WSL2中编辑、运行和调试代码，同时享受Windows桌面环境的便利。以下是完整的配置指南。

安装WSL2与Linux发行版

确保你的Windows系统支持WSL2。推荐使用Windows 10版本2004及以上或Windows 11。

• 以管理员身份打开PowerShell，执行命令启用WSL功能：
  wsl –install
  该命令会自动安装WSL2和默认的Ubuntu发行版。
• 若需手动安装，可分别执行：
  wsl –set-default-version 2
  wsl –install -d Ubuntu
• 安装完成后，启动Ubuntu并设置用户名和密码。

安装VSCode与Remote-WSL扩展

VSCode是跨平台代码编辑器，配合官方扩展可无缝连接WSL2。

• 从官网下载并安装Visual Studio Code。
• 打开VSCode，在扩展市场搜索“Remote – WSL”并安装。这是微软提供的官方扩展，由“Remote Development”扩展包包含。
• 安装后，按Ctrl+Shift+P打开命令面板，输入“Remote-WSL: New Window”即可打开一个连接到WSL2的新窗口。

在WSL2中配置开发环境

进入WSL2环境后，可以像在原生Linux中一样安装开发工具。

千帆大模型平台

面向企业开发者的一站式大模型开发及服务运行平台

0

查看详情

• 更新软件包列表：
  sudo apt update && sudo apt upgrade
• 根据项目需要安装语言环境，例如node.js、python、GCC等：
  sudo apt install nodejs npm python3-pip build-essential
• 全局安装常用工具，如yarn、pipx等，确保PATH正确配置。
• 项目文件建议放在/home/用户名/project路径下，避免跨文件系统性能损耗（不要放在/mnt/c下长期开发）。

使用VSCode进行高效开发

连接成功后，VSCode的终端将默认使用WSL2的shell，所有操作均在Linux环境中执行。

• 打开WSL中的项目文件夹，VSCode会自动识别git、linter、debugger等工具。
• 安装适用于Linux环境的VSCode插件（如Python、Prettier、ESLint），这些插件将在WSL中运行。
• 调试程序时，断点、变量查看、控制台输出均可正常使用。
• 访问本地服务（如localhost:3000）时，在Windows浏览器中直接打开即可，网络已互通。

基本上就这些。配置完成后，你可以在Windows上使用GUI应用，同时在VSCode中享受Linux开发环境的完整支持。这种组合特别适合前端、Node.js、Python、rust等跨平台项目开发。不复杂但容易忽略的是文件系统位置和权限管理，尽量在WSL文件系统内操作，避免性能问题。