【调试笔记-20240522-Windows-WSL 修改已安装发行版名称】

调试笔记-系列文章目录

调试笔记-20240522-Windows-WSL 修改已安装发行版名称

---

---

前言

本文记录在 Windows 环境下在为 WSL 已安装的发行版修改名字的方法。

实验使用的电脑如下：

CPU：

Intel Core i5 8265U

操作系统：

Microsoft Windows 10  Professional (x64), Version 22H2, Build 19045.4412

---

一、调试环境

---

操作系统：Windows 10 专业版

操作系统详细信息如下：

Microsoft Windows 10  Professional (x64), Version 22H2, Build 19045.4412

---

调试环境

• Windows 系统开启 WSL 支持，并已安装 Ubuntu 20.04 发行版本

参考【安装笔记-20240520-Windows-自定义 WSL2 安装位置】

---

调试目标

修改默认安装的发行版本名 Ubuntu 为 Ubuntu-20.04。

说明：按照【安装笔记-20240520-Windows-自定义 WSL2 安装位置】安装后，默认的发行版名称为 Ubuntu，如果尝试安装 Ubuntu-22.04 LTS 的发行版则直接打开之前安装的 WSL/Ubuntu-20.04 的环境，因为手动安装时安装程序查找的是相同的 “Ubuntu” 发行版名称。

故此，修改之前安装的 WSL/Ubuntu-20.04 的发行版名称为 “Ubuntu-20.04” ，再测试新安装 WSL/Ubuntu-22.04 LTS 是否可行。

---

二、调试步骤

方法一：修改注册表

1、打开命令行窗口，输入以下命令。

regeidt

2、在注册表中找到 HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\Lxss

3、在注册表 HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\Lxss
中找到需要修改的发行版注册表项，修改其中的 “DistributionName”

4、重启系统

---

方法二：WSL 导出/导入 发行版

1、首先，确保你想要修改的发行版不是当前正在使用的。如果是，请退出该发行版。

2、使用 wsl --list --verbose 命令查看所有发行版及其状态。

wsl --list --verbose

确保你想要修改的发行版是已停止状态。

3、使用以下命令导出发行版：

wsl --export <旧名称> <导出文件路径>

4、然后，卸载原来的发行版：

wsl --unregister <旧名称>

5、最后，使用导出的文件导入发行版，并给它赋予新的名称：

wsl --import <新名称> <安装位置> <导出文件路径> --version <版本号>

请注意，在执行这些步骤时，替换<旧名称>、<新名称>、<导出文件路径>和<安装位置>为你自己的实际信息。<版本号>应为你的 WSL 发行版的版本，例如1或2。

这些命令需要管理员权限，因此你可能需要在 Windows 的命令提示符或 PowerShell 中使用管理员权限运行它们。

---

三、应用场景

在 Windows/WSL 中安装同一发行版的不同发布版本

同时安装 Ubuntu-20.04 和 Ubuntu-22.04-LTS 进行开发测试

---

四、参考资料

1、WSL 的基本命令
2、旧版 WSL 的手动安装步骤

---

总结

本文记录在 Windows 环境下在为 WSL 已安装的发行版修改名字的方法，并指出过程中遇到的问题及解决方法。