实操02:Windows用户安装WSL——完整图文教程

在Windows上安装WSL（Windows Subsystem for Linux），也就是我们之前说的“Windows里面的Linux房间”。

装好之后，你就能在Windows里直接运行Linux命令和工具，后面部署Claude Code、OpenCode都会用到。

需要什么？

Windows 10 版本2004以上或 Windows 11
管理员权限（公司电脑可能被锁，自己的电脑一般没问题）
20分钟左右
稳定的网络（下载Ubuntu需要）

怎么检查Windows版本？

按Win + R，输入winver，回车
看弹窗里的“版本号”
Windows 10 需要 2004 或更高（18362以上）
Windows 11 都可以

第零步：看看你的电脑是什么“底子”

在开始安装之前，先花10秒钟看一眼你的电脑配置。后面有个小地方会用到。

怎么查看：

右键点击桌面上的 “此电脑” 或 “我的电脑”
选择属性
在打开的窗口里，找到 “处理器” 这一行

你会看到类似这样的文字：

Intel(R) Core(TM) i5-xxxx → Intel 平台
AMD Ryzen 5 xxxx → AMD 平台
Snapdragon X Elite → ARM 平台（比较少见）

为什么需要知道这个？

有两个原因：

原因一：下载Ubuntu时，架构会自动匹配，但了解自己的CPU类型能让你心里有底。

绝大多数个人电脑是 Intel 或 AMD，它们都用 amd64 架构版本。这个名字虽然带“AMD”，但Intel电脑也用它——这是64位PC的标准叫法，不用纠结。

原因二（更重要）：后面如果你想让AI工具跑得更快（用显卡加速），Intel、AMD、ARM 需要的驱动和命令不一样。

不着急，到时候实操06会再提醒你。现在只需要知道：先记下自己的CPU型号，后面用得上。

一个快速记录表

你的CPU类型	在本文中你只需要知道
Intel	用 amd64 架构（正常装就行）
AMD	用 amd64 架构（正常装就行）
ARM（骁龙等）	会自动装 arm64 版本，少数工具可能需要特殊处理

99%的读者都是前两种，正常跟着教程走就行。

第一步：开启WSL功能

右键点击“开始”按钮（或按 `Win + X`）
选择 **Windows PowerShell（管理员）** 或 **终端（管理员）**
在弹出的黑窗口里，输入下面这行命令：

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

4. 回车，等待进度条到100%

这一步在干嘛？告诉Windows：“我要打开WSL这个功能。”

第二步：开启虚拟机平台（WSL 2需要）

WSL有两个版本。WSL 1够用，但WSL 2性能更好、兼容性更强。我们装WSL 2。

输入下面这行命令：

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

回车，等待完成。

截图示意：第二条命令的执行界面

第三步：重启电脑

两条命令都执行完后，重启电脑。

不重启的话，后面会报错。

第四步：下载安装Linux发行版（Ubuntu）

在浏览器中直接搜索 `Ubuntu`，选择Get Ubuntu on WSL

根据电脑硬件的不同选择不同的版本然后点击Download.

第五步：启动Ubuntu

安装完成后，点击打开，或者在开始菜单里找到Ubuntu并打开。

第一次启动会需要几分钟，显示“Installing...”的提示。等它自己跑完。

第六步：设置用户名和密码

安装完成后，会提示你输入用户名（Unix username）：

Enter new UNIX username:

输入一个名字，比如你的名字拼音（小写字母，不要用中文）。回车。

New password:

输入密码（屏幕上不会显示任何字符，这是正常的）。回车。

确认密码（Retype new password）：再输一遍。

重要：这个密码是WSL里Linux系统的密码，和你的Windows密码没关系。记住它，后面安装软件、运行sudo命令都会用到。

第七步：更新软件包（推荐）

装好之后，先更新一下系统里的软件列表。

在Ubuntu终端里依次输入：

sudo apt update

（会提示输入密码，就是你刚才设的那个）

sudo apt upgrade

输入 `y` 确认，等待完成。

这一步不是必须的，但能避免后面装工具时遇到奇怪的问题。

验证一下：WSL装好了吗？

在Ubuntu终端里输入：

lsb_release -a

应该能看到Ubuntu的版本信息。

再输入：

cd /ls

应该能看到Linux的根目录（bin、home、usr等文件夹）。

如果你看到这些，恭喜——WSL装好了。

常见问题

问题	原因	解决办法
命令提示“不是内部或外部命令”	没用管理员权限	右键“以管理员身份”重新打开PowerShell
Microsoft Store找不到Ubuntu	商店被公司禁用/网络问题	去官网手动下载Ubuntu安装包
启动Ubuntu后闪退	WSL功能没开全	检查第一步和第二步是否都执行了，重启后再试
输入密码时没反应	正常现象	直接输入，回车就行，屏幕上不会显示
sudo apt update 很慢	连接国外服务器慢	换国内镜像源（搜“Ubuntu换清华源”）

## 装好WSL后，怎么用？

以后每次需要用Linux环境时：

打开开始菜单，点击Ubuntu图标
或者按Win + R，输入bash，回车
或者进入正常终端之后再输入wsl

开头的Linux终端。在里面可以：

用ls 看文件（不是dir）
用cd 走进文件夹
用sudo apt install 安装Linux软件
跑了那些为Linux写的AI工具

文件互通：你在WSL里可以直接访问Windows的C盘和D盘，它们在 `/mnt/c/` 和 `/mnt/d/` 下面。

试试这个命令：

ls /mnt/c/Users/

会显示Windows的用户文件夹列表。

总结

步骤	操作
1	管理员PowerShell开启WSL功能
2	开启虚拟机平台
3	重启电脑
4	Microsoft Store安装Ubuntu
5	启动Ubuntu
6	设置用户名和密码
7	（可选）sudo apt update && upgrade

装好之后，你的Windows就有了一个Linux子系统。后面部署Claude Code、OpenCode，都会在这个Ubuntu终端里操作。

下一篇预告

实操04：拿到你的第一个API Key——各大平台注册教程

手把手教你从DeepSeek、OpenAI、阿里云等平台获取API Key。

下期见。