WSL 安装 Ubuntu 并改名为所需名称

文档简介

本文按两条线索完整说明 WSL Ubuntu 子系统：

  • 线索一：从 0 安装到配置设置 —— 启用 WSL → 解压 .appx 安装包 → 初始化建用户 → 把发行版改名为所需名称 → 同步 Windows Terminal 显示名 → 改名后的常用命令。
  • 线索二：完全卸载 —— 注销发行版、清理虚拟磁盘与残留文件、清理注册表、清理终端配置、可选关闭 WSL 功能。

适用环境：Windows 10 2004+ / Windows 11。文中「所需名称」为举例，实际可换成任意你想用的名字（如 Ubuntu-OpenClaw）。

线索一：从 0 安装到配置设置

1. 启用 WSL 前置（首次安装必做）

如果电脑从没装过 WSL，先启用两个系统功能：

  1. 打开「控制面板 → 程序和功能 → 启用或关闭 Windows 功能」；
  2. 勾选 「适用于 Linux 的 Windows 子系统」 和 「虚拟机平台」；
  3. 点击确定，重启电脑。

也可以直接在 PowerShell（管理员）里一键安装：

1
wsl --install

安装完成后重启，再用 wsl --status 确认 WSL 可用。

说明：离线 .appx 安装包方式不需要联网下载发行版，适合内网/无外网环境，也适合手动指定安装位置（如放到 J: 盘）。

2. 解压 Ubuntu .appx 安装包

.appx 本质是一个 zip 压缩包，可以直接解压。用 PowerShell 执行（路径换成你的实际路径）：

1
2
Add-Type -AssemblyName System.IO.Compression.FileSystem
[System.IO.Compression.ZipFile]::ExtractToDirectory("J:\Ubuntu_2204.1.7.0_x64.appx", "J:\WSL\Ubuntu-openclaw")
  • 前半段为安装包路径，后半段为目标解压目录（会自动创建）。

如果解压报「目标目录已存在」，先清空或换目录名再执行：

1
Remove-Item "J:\WSL\Ubuntu-openclaw" -Recurse -Force

也可以换用系统自带的解压命令（三选一即可）：

1
2
3
4
5
# 方式一：Expand-Archive
Expand-Archive -Path "J:\Ubuntu_2204.1.7.0_x64.appx" -DestinationPath "J:\WSL\Ubuntu-openclaw"

# 方式二：tar（Windows 10 1803+ 自带）
tar -xf "J:\Ubuntu_2204.1.7.0_x64.appx" -C "J:\WSL\Ubuntu-openclaw"

3. 初始化发行版（首次启动建用户）

  1. 打开资源管理器，进入解压目录：J:\WSL\Ubuntu-openclaw；
  2. **双击 ubuntu.exe**（或在该目录 PowerShell 里执行 .\ubuntu.exe）；
  3. 等待初始化，按提示设置 用户名 和 密码（Linux 下输入密码不显示字符，属正常现象）；
  4. 出现命令行提示符即说明发行版注册成功。

此时执行 wsl -l -v 应能看到一个名为 Ubuntu 的发行版（这就是待改名的对象）。

4. 把发行版改名为所需名称（注册表法）

WSL 发行版的「名字」记录在注册表里，改名字就是改注册表里的 DistributionName 值。

第 1 步：先关闭 WSL（推荐，避免占用）

1
wsl --shutdown

第 2 步：打开注册表编辑器

  1. 按 Win + R，输入 regedit，回车；
  2. 定位路径：
1
HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Lxss

第 3 步：找到目标发行版

点开 Lxss 下面的每一串大括号 {...} GUID 文件夹，逐个查看里面的 DistributionName 值，找到值等于 Ubuntu 的那一项。

第 4 步：改名

  1. 双击该 GUID 下的 DistributionName；
  2. 把「数值数据」改成你的所需名称，例如：Ubuntu-OpenClaw；
  3. 点击确定保存，关闭注册表编辑器。

改完后重新打开一个 PowerShell，执行 wsl -l -v 验证——应显示新名字。

说明：改名只改显示名和命令行识别名，不会影响已装的软件、用户和文件系统（都存于同一个 ext4.vhdx 虚拟磁盘里），可放心改。

5. Windows Terminal 显示改名

终端侧边栏里的名字自动读取 WSL 名，但建议手动覆盖一下，让标签名也显示成新名字。

  1. 打开 Windows Terminal；
  2. 按 Ctrl + , 进入设置；
  3. 左下角点 「打开 JSON 文件」（打开 settings.json）；
  4. 找到 source 为 Microsoft.WSL 的那条配置，补充 name 和 tabTitle：
1
2
3
4
5
6
{
    "guid": "{1b34ceb0-...原样保留}",
    "name": "Ubuntu-OpenClaw",
    "tabTitle": "Ubuntu-OpenClaw",
    "source": "Microsoft.WSL"
}
  1. 保存文件，重启 Windows Terminal。

之后终端左侧列表、标签标题都会显示新名字。

6. 改名后的常用命令

改名后，旧名 Ubuntu 的命令全部失效，统一用新名字：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
# 列出所有发行版（确认名字和版本）
wsl -l -v

# 以新名字进入 Ubuntu 子系统
wsl -d Ubuntu-OpenClaw

# 直接进入并停在指定用户的主目录
wsl -d Ubuntu-OpenClaw ~

# 终止（关闭）指定发行版
wsl --terminate Ubuntu-OpenClaw

# 关闭所有 WSL 发行版
wsl --shutdown

# 把新名字设为默认发行版（之后 wsl 直接进它）
wsl --set-default Ubuntu-OpenClaw

线索二：完全卸载

卸载不可逆，会彻底删除该发行版的所有数据（用户、文件、已装软件）。如需保留数据，先备份 ext4.vhdx 虚拟磁盘文件再操作。

1. 关闭并注销发行版

先关闭所有 WSL 会话：

1
wsl --shutdown

注销发行版（会删除整个文件系统及对应的注册表项）：

1
wsl --unregister Ubuntu-OpenClaw

注销后 wsl -l -v 里该发行版应消失。如果 --unregister 后仍有残留，继续下面步骤。

2. 删除残留的虚拟磁盘与安装目录

.appx 解压方式安装的发行版，数据在解压目录里（例如 J:\WSL\Ubuntu-openclaw），注销后可能残留 ext4.vhdx 等文件。手动删除整个目录：

1
Remove-Item "J:\WSL\Ubuntu-openclaw" -Recurse -Force

如果之前用商店 / wsl --install 安装，数据默认在 %LOCALAPPDATA%\Packages\<发行版包名>\LocalState\ext4.vhdx，注销后一般会自动清理，可一并检查删除。

3. 清理注册表残留项

如果 --unregister 没有自动清掉注册表项，手动删除：

  1. Win + R 输入 regedit 回车；
  2. 定位路径：
1
HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Lxss
  1. 找到名字对应该发行版的 {...} GUID 文件夹；
  2. 右键 删除 该 GUID 项（只删目标发行版对应项，不要误删其他发行版）。

4. 清理 Windows Terminal 配置

删除 settings.json 里 source: "Microsoft.WSL" 对应的那一条配置，避免终端残留失效入口。

5. 可选：彻底关闭 WSL 功能

如果整个 WSL 都不再需要：

1
2
# 移除 WSL 组件本身（Windows 11）
wsl --uninstall

或在「控制面板 → 启用或关闭 Windows 功能」里取消勾选「适用于 Linux 的 Windows 子系统」和「虚拟机平台」，重启电脑。

常见问题与排错

问题现象 原因与解决
注册表里找不到 DistributionName = Ubuntu 实际注册名可能不同（如 Ubuntu-22.04）。执行 wsl -l -v 看真实名字，再去注册表找对应项
改名后 wsl -d <新名> 报「不存在该发行版」 注册表没保存成功或未生效。重开注册表确认值，执行 wsl --shutdown 后再试
双击 ubuntu.exe 闪退/报错 大概率 WSL 功能未启用或改完没重启电脑；或安装包架构（32/64 位）与系统不匹配
解压报「目标目录已存在」 目标目录已有内容，先删除或更换目录名
改完名后原「Ubuntu」快捷方式/命令失效 正常现象，旧名已移除，统一改用 wsl -d <新名>
--unregister 后 wsl -l -v 仍显示 注册表残留，按线索二第 3 步手动删除对应 GUID 项

小结

  • 安装配置：启用 WSL → 解压 .appx → 双击 ubuntu.exe 建用户 → 改注册表 DistributionName 为所需名称 → 同步终端 JSON 显示名 → 用 wsl -d <新名> 管理。
  • 完全卸载：wsl --shutdown → wsl --unregister <新名> → 删残留目录/注册表/终端配置 → 可选 wsl --uninstall 关闭功能。
  • 改名不影响已有数据且可逆；卸载不可逆，卸载前务必确认是否需备份。