Win11怎么使用wsl --export和wsl --import备份还原开发环境

大枫酱_9908

大枫酱_9908

2026-10-20

456人浏览

原创

重装前必须做的三件事:确认并设置wsl.conf中[user]段default为常用用户名;重启发行版使配置生效;执行wsl --shutdown关闭所有实例。

win11怎么使用wsl --export和wsl --import备份还原开发环境

Windows 11重装系统前,想把正在用的WSL2 Ubuntu开发环境(含已装的Python包、Docker配置、项目代码和SSH密钥)原样保存下来,重装后立刻复用,不重装软件、不重新配置、不丢失数据。

导出前必须做的三件事

导出前不检查默认用户,导入后可能直接以root身份登录,导致/home下原有用户目录不可见,所有配置文件和项目全“消失”。

在WSL终端中执行:cat /etc/wsl.conf,确认输出里有[user]段且default=后是你常用用户名(比如default=john)。没有就立刻补上:

sudo bash -c "echo -e '\n[user]\ndefault=$(whoami)' >> /etc/wsl.conf"

这行命令会自动把当前用户名写进wsl.conf,避免手动输错。写完后重启该发行版:先在PowerShell中运行wsl --terminate Ubuntu-22.04,再输入wsl -d Ubuntu-22.04重新进入,确保新配置已生效。

最后一步:关闭全部WSL实例,否则导出会失败并报错Access is denied——这是最常被跳过的致命步骤。

【wsl --shutdown 必须执行,且要在导出命令前立即运行】

用wsl --export备份整个发行版

打开PowerShell(无需管理员权限),执行导出命令:

wsl --export Ubuntu-22.04 D:\wsl-backup\ubuntu-22.04-20261019.tar

路径必须是绝对路径,不能用~或%USERPROFILE%;文件名建议带日期,避免覆盖旧备份;目标盘(这里是D:\)需有足够空间——一个装了Docker+Node.js+Python生态的Ubuntu通常占3–8GB。

导出过程无进度条,耐心等1–5分钟。完成后检查D:\wsl-backup\目录下是否生成了对应.tar文件,大小应与你预估的发行版实际占用空间接近(可用wsl -d Ubuntu-22.04 -e du -sh /粗略估算)。

重装Win11后导入恢复环境

第一步:在新系统中安装WSL2基础环境。

以管理员身份运行PowerShell,依次执行:

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

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

重启电脑。再运行wsl --update升级内核,然后设默认版本:wsl --set-default-version 2。

第二步:导入备份。

执行导入命令,注意三个关键点:

① 目标安装路径必须是**空文件夹**,不能是已存在的发行版目录,否则报错Failed to import;

笔目鱼英文论文写作器
笔目鱼英文论文写作器

一款AI论文写作工具,主要用于写高质量英文论文,就用笔目鱼,适合需要提升相关任务效率的用户。

下载

② 导入时指定的发行版名称(如MyUbuntu)可以和原名不同,但后续要用这个新名字操作;

③ 【不要漏掉--version 2参数,否则默认导入为WSL1,性能暴跌且不支持Docker】

wsl --import MyUbuntu D:\wsl-installs\myubuntu D:\wsl-backup\ubuntu-22.04-20261019.tar --version 2

第三步:设置默认用户。

导入后默认用户是root,必须手动切换回原用户:

先运行wsl -d MyUbuntu进入,再执行:

sudo /usr/sbin/usermod -s /bin/bash john(把john换成你原来的用户名)

然后退出:exit,再用这行命令永久绑定默认用户:

wsl -d MyUbuntu -u john

验证环境是否完整还原

方法一:直接启动并检查核心状态

在PowerShell中运行wsl -d MyUbuntu -u john,进入后立刻执行:

python3 --version && docker --version && ls -la ~/project

三项都应正常返回结果,特别是~/project目录必须存在且内容完整——这是判断代码和配置是否丢失的最快方式。

方法二:比对关键配置文件哈希值(可选)

如果原环境导出前曾记录过sha256sum ~/.ssh/id_rsa.pub,现在可重新计算对比,确认密钥未被替换。

方法三:测试网络与代理连通性

运行curl -I https://pypi.org,若返回HTTP 200且响应头含Server: nginx,说明DNS、HTTPS、代理(如有)全部继承成功。

相关专题

更多
GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

0

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

0

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

0

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

0

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

0

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

0

16

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

160

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

120

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

100

15

热门下载

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

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习