【安装Linux on Windows with WSL】包括 VS Code 和 Git
1. 安装 WSL 环境
打开 PowerShell(或 Windows 命令提示符)并输入:
wsl --install
- 如果下载速度太慢,请连接到手机热点重试。
- 安装完成后重启计算机。
2. 安装 Linux 本体
再次在 PowerShell(或 Windows 命令提示符)输入:
wsl --install
此时会安装下载并安装 Ubuntu Linux 发行版(可能需要重新启动)。
打开开始菜单
上的企鹅头像的WSL
,能打开就直接跳转到5.设置 Linux 用户名和密码,别浪费时间。
否则按以下顺序挨个试,。
3. 检查并启用必要的 Windows 功能
确保以下功能已启用:
- Hyper-V (如果没有找到,见下)
- 虚拟机平台(Virtual Machine Platform)
- 适用于 Linux 的 Windows 子系统(Windows Subsystem for Linux)
可以通过以下步骤检查和启用这些功能:
- 按下
Win + R
键,输入OptionalFeatures
并回车。 - 在“可选功能”窗口中,勾选上述功能。
- 如果提示重启,请重启计算机。
异常情况:若没有找到 Hyper-V
- 手动安装 Hyper-V
如果系统缺少 Hyper-V 组件,可以尝试手动安装。以下是通过命令行安装 Hyper-V 的方法:
- 将以下内容复制到文本文件中,并将文件命名为
Hyper-V.cmd
:
pushd "%~dp0"
dir /b %SystemRoot%\servicing\Packages\*Hyper-V*.mum >hyper-v.txt
for /f %%i in ('findstr /i . hyper-v.txt 2^>nul') do dism /online /norestart /add-package:"%SystemRoot%\servicing\Packages\%%i"
del hyper-v.txt
Dism /online /enable-feature /featurename:Microsoft-Hyper-V-All /LimitAccess /ALL
- 以管理员身份运行该文件,完成后重启计算机。
4. 检查虚拟化支持
确保你的 BIOS 中已启用虚拟化技术(如 Intel VT-x 或 AMD-V)。可以通过以下步骤检查:
- 重启计算机并进入 BIOS 设置(通常按
Del
、F2
或Esc
键)。 - 找到“虚拟化技术”或“Virtual Technology”选项,确保其已启用。
5.设置 Linux 用户名和密码
使用 WSL 安装 Linux 发行版的过程完成后,使用“开始”菜单打开该发行版(默认情况下为 Ubuntu)。 系统将要求你为 Linux 发行版创建“用户名”和“密码”。
-
此用户名和密码特定于安装的每个单独的 Linux 分发版,与 Windows 用户名无关。
-
请注意,输入密码时,屏幕上不会显示任何内容。 这称为盲人键入。 你不会看到你正在键入的内容,这是完全正常的。
-
创建用户名和密码后,该帐户将是分发版的默认用户,并将在启动时自动登录。
-
此帐户将被视为 Linux 管理员,能够运行
sudo
(Super User Do) 管理命令。 -
在 WSL 上运行的每个 Linux 发行版都有其自己的 Linux 用户帐户和密码。 每当添加分发版、重新安装或重置时,都必须配置一个 Linux 用户帐户。
6.使用 VS Code
假设 VS Code 已经安装在 Windows ,你还需要安装远程开发扩展包。
- 除了 Remote - SSH 和 Dev Containers 扩展之外,此扩展包还包含 WSL 扩展,使你能够打开容器中、远程计算机上或 WSL 中的任何文件夹。
7.在 VS Code 中打开 WSL 项目
从 VS Code 中
点击VS Code 右下角蓝色块
或通过快捷键CTRL+SHIFT+P
调出命令面板,选择连接到 WSL
。建议先在WSL
命令行中创建下文件夹:
mkdir develop
chmod 777 develop
cd develop
mkdir WSL2init
8. 设置 Git
假设你在 Windows 上已经配置了 SSH 密钥,那就无需在 WSL2 中重新进行身份验证。
但是你需要重新配置 WSL 里 Git 的全局用户名和邮箱。运行以下命令:
git config --global user.name "Your Name"
git config --global user.email "your_email@example.com"
将 Your Name
和 your_email@example.com
替换为你的 GitHub 用户名和邮箱。
使用git clone
验证是否成功。
参考来源:
安装 WSL | Microsoft Learn
设置 WSL 开发环境 | Microsoft Learn
关于适用于 Linux 的 Windows 子系统的常见问题解答 | Microsoft Learn
开始通过 WSL 使用 VS Code | Microsoft Learn
开始在 WSL 上使用 Git | Microsoft Learn
解决Enable-WindowsOptionalFeature : 功能名称 Microsoft-Hyper-V 未知。-阿里云开发者社区