调试笔记-系列文章目录
调试笔记-20240522-Windows-WSL 修改已安装发行版名称
文章目录
- 调试笔记-系列文章目录
- 调试笔记-20240522-Windows-WSL 修改已安装发行版名称
- 前言
- 一、调试环境
- 操作系统：Windows 10 专业版
- 调试环境
- 调试目标
- 二、调试步骤
- 方法一：修改注册表
- 方法二：WSL 导出/导入 发行版
- 三、应用场景
- 在 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 已安装的发行版修改名字的方法，并指出过程中遇到的问题及解决方法。
