重装前必须做的三件事：确认并设置wsl.conf中[user]段default为常用用户名；重启发行版使配置生效；执行wsl --shutdown关闭所有实例。
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；
② 导入时指定的发行版名称（如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、代理（如有）全部继承成功。
