Windows 安装 WSL 全攻略:wsl --install 一键部署 + VSCode 搭配使用好处详解
前言
在 Windows 上做开发,尤其是后端、C/C++、Python、Docker、机器学习等开发时,经常会遇到环境不一致、命令不兼容、依赖难装等问题。
传统虚拟机笨重卡顿,双系统切换麻烦,而 WSL(Windows Subsystem for Linux) 完美解决了这些痛点。
本文详细介绍:
- Windows 安装 WSL 的好处
- 一条命令
wsl --install完成安装 - VSCode 配合 WSL 开发的极致体验
- 简单配置与常见问题
适合开发新手、后端工程师、运维、学生党快速搭建 Linux 开发环境。
一、什么是 WSL
WSL 全称 Windows Subsystem for Linux ,是微软官方推出的,可以在 Windows 系统中直接运行 Linux 环境的子系统。
它不是虚拟机,轻量、启动快、和 Windows 无缝互通,目前主流使用 WSL2。
二、Windows 安装 WSL 的好处
1. 轻量高效,比虚拟机快太多
- 无完整 ISO 镜像
- 启动秒开,资源占用极低
- 性能接近原生 Linux,远超 VMware / VirtualBox
2. 完美 Linux 环境,开发更舒服
- 原生支持
apt、yum等包管理器 - 可以跑 shell、nginx、redis、mysql、docker
- 编译 C/C++、Go、Rust 无兼容问题
3. 与 Windows 文件系统互通
- Windows 磁盘在
/mnt/c、/mnt/d直接访问 - Linux 文件也能在 Windows 资源管理器打开
- 双向复制粘贴、编辑都非常方便
4. 无需重启、无需切换系统
一边用 Windows 办公、聊天、浏览器
一边开 Linux 终端跑服务,互不干扰
5. 支持 Docker 等现代开发工具
WSL2 下 Docker 性能极佳,是 Windows 上最舒服的 Docker 方案
6. 配合 VSCode 实现"远程开发"体验
可以直接在 Windows 上的 VSCode 编辑 Linux 里的代码,终端、调试、运行全部打通。
三、安装 WSL 命令:wsl --install
1. 系统要求
- Windows 10 2004 版本以上
- Windows 11 所有版本
2. 一键安装命令
以管理员身份 打开 PowerShell 或 CMD,执行:
bash
wsl --install
执行后会自动:
- 开启 WSL 功能
- 开启虚拟机平台功能
- 自动下载并安装 Ubuntu(默认发行版)
- 设置用户名和密码
安装完成后重启电脑。
3. 查看安装的发行版
bash
wsl -l -v
4. 设置默认 WSL 版本(确保是 WSL2)
bash
wsl --set-default-version 2
四、VSCode 搭配 WSL 使用方法
1. 安装插件
打开 VSCode,搜索插件:
Remote - WSL
安装后重启 VSCode。
2. 连接 WSL
点击 VSCode 左下角 绿色远程图标
选择 New WSL Window
即可直接进入 Linux 环境。
3. 优势体验
- 代码文件存在 Linux 中,路径无中文、无空格问题
- 终端直接是 Linux bash
- 调试、运行、Git 完全一致
- Windows 与 Linux 环境无缝切换
- 适合 Django、Flask、Node、Vue、C++ 等各类开发
五、简单初始化(可选)
bash
# 更新源
sudo apt update && sudo apt upgrade -y
# 安装常用工具
sudo apt install git curl wget gcc g++ make -y
六、常见问题
-
提示"wsl 不是内部命令"
→ 系统版本过低,升级 Windows 或手动开启 WSL 功能。
-
安装卡住
→ 检查网络,或换镜像源。
-
文件权限问题
→ WSL2 中尽量将项目放在 Linux 目录而非 /mnt 下。
-
VSCode 连接失败
→ 重启 WSL:
wsl --shutdown
总结
- wsl --install 一条命令完成 WSL 安装,简单高效
- WSL 轻量、快速、原生 Linux 体验
- VSCode + WSL 是 Windows 下最舒服的开发组合
- 适合学习 Linux、后端开发、运维、AI 编程等场景
如果你还在 Windows 上折腾虚拟机,强烈建议直接上 WSL,开发效率提升非常明显。