Windows 怎么使用 wsl 命令行工具导出和导入 WSL 发行版镜像

胖宇姑娘_2797

胖宇姑娘_2797

2026-08-11

1017人浏览

原创

能完成wsl迁移,核心是用wsl --export导出发行版为.tar镜像(需先wsl -l -v查名称、wsl --shutdown确保停止),再用wsl --import指定新路径重建实例(路径须为空、显式加--version 2),最后配置默认用户。

直接用 wsl --export 和 wsl --import 就能完成导出与导入,整个过程不依赖图形界面,全部在 powershell(管理员权限)中执行,核心是打包系统状态 + 换位置重建实例。

导出当前发行版为 tar 镜像

导出前确保目标发行版已停止,否则可能产生不一致的备份。

  • 先查清发行版名称和状态:wsl -l -v,记下你要操作的名字(如 Ubuntu-24.04)
  • 若状态不是 Stopped,用 wsl --terminate Ubuntu-24.04 或 wsl --shutdown 全局关闭
  • 执行导出命令,生成一个完整根文件系统的 tar 包:
    wsl --export Ubuntu-24.04 D:\backup\ubuntu2404.tar
  • 导出耗时取决于系统大小,完成后得到单个 .tar 文件,它包含所有用户数据、配置和已装软件

导入镜像到新位置(含非 C 盘路径)

导入不是解压文件夹,而是重建一个可运行的 WSL 实例——自动初始化虚拟磁盘、挂载点和内核关联。

SoundView
SoundView

SoundView是一款面向跨境电商的视频翻译、配音和本地化 AI 创作平台。

下载
  • 先创建空的目标目录(不能有同名文件或子目录):
    New-Item -Path "D:\WSL\Ubuntu2404" -ItemType Directory
  • 运行导入命令,指定名称、安装路径和镜像文件:
    wsl --import Ubuntu-24.04 D:\WSL\Ubuntu2404 D:\backup\ubuntu2404.tar --version 2
  • 注意:导入路径必须是空文件夹;--version 2 显式指定 WSL2(推荐),避免使用默认版本造成兼容问题
  • 成功后,wsl -l -v 会显示新实例,状态为 Stopped,此时尚未设置默认用户

恢复默认登录用户(避免每次进 root)

通过 --import 创建的实例默认以 root 启动,需手动配置普通用户并设为默认。

  • 首次启动:wsl -d Ubuntu-24.04,进入后创建用户(如 adduser dev)、加 sudo 权限、设密码
  • 退出 WSL,在 PowerShell 中运行:
    ubuntu2404 config --default-user dev(把 ubuntu2404 替换为你的发行版实际名称,区分大小写)
  • 验证:直接运行 wsl -d Ubuntu-24.04,应自动以 dev 用户登录,whoami 可确认

常见问题处理

遇到报错时优先检查三件事:路径是否存在、是否为空、镜像格式是否为 tar。

  • 报错 Invalid argument 或 Access is denied:PowerShell 未以管理员身份运行
  • 报错 The specified path does not exist:检查 D:\WSL\Ubuntu2404 是否真为空目录,或路径拼写错误(反斜杠/斜杠混用)
  • 镜像不是 .tar?下载的是 .appx 或 .zip,需先重命名为 .zip 并解压出内部的 .tar 文件再导入
  • 导入后启动慢或卡住:可能是 WSL2 内核未更新,运行 wsl --update 升级后再试

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

windows系统

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
磁盘配额是什么
磁盘配额是什么

磁盘配额是计算机中指定磁盘的储存限制,就是管理员可以为用户所能使用的磁盘空间进行配额限制,每一用户只能使用最大配额范围内的磁盘空间。php中文网为大家提供各种磁盘配额相关的内容,教程,供大家免费下载安装。

2023.06.21

3710

4

如何安装LINUX
如何安装LINUX

本站专题提供如何安装LINUX的相关教程文章,还有相关的下载、课程,大家可以免费体验。

2023.06.29

3213

10

linux find
linux find

find是linux命令,它将档案系统内符合 expression 的档案列出来。可以指要档案的名称、类别、时间、大小、权限等不同资讯的组合,只有完全相符的才会被列出来。find根据下列规则判断 path 和 expression,在命令列上第一个 - ( ) , ! 之前的部分为 path,之后的是 expression。还有指DOS 命令 find,Excel 函数 find等。本站专题提供linux find相关教程文章,还有相关

2023.06.30

2293

5

linux修改文件名
linux修改文件名

本专题为大家提供linux修改文件名相关的文章,这些文章可以帮助用户快速轻松地完成文件名的修改工作,大家可以免费体验。

2023.07.05

5490

7

linux系统安装教程
linux系统安装教程

linux系统是一种可以免费使用,自由传播,多用户、多任务、多线程、多CPU的操作系统。本专题提供linux系统安装教程相关的文章,大家可以免费体验。

2023.07.06

5162

7

linux查看文件夹大小
linux查看文件夹大小

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。linux怎么查看文件夹大小呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.20

3073

8

linux查看ip命令
linux查看ip命令

本专题为大家提供linux查看ip命令相关文章内容,感兴趣的朋友可以免费下载体验试试。

2023.07.20

2585

4

linux查看cpu使用率
linux查看cpu使用率

在linux的系统维护中,可能需要经常查看cpu使用率,分析系统整体的运行情况。本专题为大家带来了linux查看cpu使用率的相关文章,感兴趣的朋友千万不要错过了。

2023.07.25

2799

6

linux查找文件命令
linux查找文件命令

Linux是一种自由和开放源码的类Unix操作系统,存在着许多不同的Linux版本,但它们都使用了Linux内核。Linux可安装在各种计算机硬件设备中,比如手机、平板电脑、路由器、视频游戏控制台、台式计算机、大型机和超级计算机。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.07.31

277

3

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
HBuilderX Windows 安装手册
HBuilderX Windows 安装手册

共0课时 | 0人学习

phpEnv手册
phpEnv手册

共0课时 | 0人学习

好课诞生记
好课诞生记

共20课时 | 7.1万人学习