跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / Bash

WSL 2 Ubuntu 22.04 安装及 D 盘迁移配置指南

综述由AI生成WSL 2 Ubuntu 22.04 安装过程中常因版本过旧导致导入失败或命令无效。详述了更新 WSL 版本的必要性,提供通过官方命令一键安装 Ubuntu 22.04 的步骤,并指导如何将默认安装在 C 盘的实例导出后重新导入至 D 盘以释放系统空间。关键操作包括使用 wsl --update 升级环境,在 PowerShell 中执行管理命令,以及在 Ubuntu 终端内更新软件包。迁移时需先关闭实例,避免文件占用错误。

赛博行者发布于 2026/3/15更新于 2026/5/3031 浏览

核心需求

  1. 装 WSL 2 版本的 Ubuntu 22.04(WSL 1 兼容性太差,怕后续跑工具出问题);
  2. 系统必须放 D 盘,C 盘空间实在扛不住;
  3. 不用国内镜像源,优先用微软官方渠道;
  4. 步骤简单好懂,别搞太复杂的操作。

最开始尝试导入 ubuntu2204.tar 文件时直接报错,发现并非现成的 WSL 镜像可用。

常见错误排查

坑 1:导入时直接报'未指定的错误'

在 PowerShell 里执行导入命令:

wsl --import Ubuntu-22.04 D:\WSL\Ubuntu2204 D:\WSL\ubuntu2204.tar --version 2 

结果弹出'未指定的错误'。反复核对路径、文件名后问题依旧。

坑 2:想查 WSL 版本,却提示'命令无效'

输入 wsl --version 报错'命令行选项无效'。此时意识到 WSL 是 Windows 自带的旧版本(收件箱版本),不支持基础命令,更无法兼容新版 Ubuntu 的导入。

坑 3:升级 WSL 后,才发现 tar 包格式错了

升级完 WSL 再导入,报错具体了:

Ubuntu_2204.1.7.0_x64.appx: ZIP uncompressed data is wrong size (read 574740460, expected 0) bsdtar: Error exit delayed from previous errors. 导入分发失败。错误代码:Wsl/Service/RegisterDistro/WSL_E_IMPORT_FAILED 

原来手里的 ubuntu2204.tar 是被重命名的 Windows 应用商店 APPX 安装包(本质是 ZIP 格式)。WSL 导入只认包含 Linux 根目录(/bin、/etc 等)的纯净 tar 包,APPX 包完全不兼容。

坑 4:在 Ubuntu 终端里跑 Windows 命令

中间犯了个低级错:想关 WSL 实例,在 Ubuntu 终端里输 wsl --shutdown,提示'wsl: command not found'。后来分清:wsl 是 Windows 命令,只能在 PowerShell 里用;Ubuntu 终端里只能跑 Linux 命令。

安装与迁移步骤

更新 WSL 是解决所有兼容性问题的关键。旧版 WSL 的 bug 太多,不管是导入报错还是命令无效,更新后基本都能解决。

步骤 1:升级 WSL 到最新版

打开「管理员 PowerShell」(后面所有 Windows 端命令都在这执行),输入升级命令:

wsl --update 

等待几分钟,更新完成后如果提示重启,就重启电脑。这一步千万别省,之前所有的'未指定错误',本质都是旧版 WSL 的兼容问题。

步骤 2:用微软官方命令一键装 Ubuntu 22.04

直接用 WSL 官方一键安装命令,自动从微软服务器下载正确的镜像:

wsl --install -d Ubuntu-22.04 

执行后会自动下载、配置 WSL 2,完成后会自动弹出 Ubuntu 终端,按提示操作:

  1. 输入 UNIX 用户名(设为 szx,随便起,不用和 Windows 用户名一致);
  2. 设密码(输入时不显示字符,正常输就行,输完按回车,再重复输一次确认);
  3. 后面提示填姓名、电话这些,直接按回车跳过就行。

步骤 3:退出 Ubuntu 终端,准备迁移到 D 盘

安装完先退出 Ubuntu 终端,三种方法任选:

  1. 直接点终端窗口右上角的'×'关闭;
  2. 输入 exit 再按回车;
  3. 按 Ctrl + D 快捷键。

步骤 4:把 Ubuntu 迁移到 D 盘(避免占 C 盘)

全程在管理员 PowerShell 里执行,步骤很简单:

设置默认用户为之前建的 szx(避免下次启动进 root 账户):

ubuntu2204 config --default-user szx 

先关闭所有 WSL 实例,防止文件被占用:

wsl --shutdown 

把 C 盘的 Ubuntu 导出成 tar 镜像到 D 盘(确保 D:\WSL 文件夹已存在):

wsl --export Ubuntu-22.04 D:\WSL\ubuntu2204_szx.tar 

注销 C 盘的 Ubuntu 实例(释放 C 盘空间):

wsl --unregister Ubuntu-22.04 

把镜像重新导入到 D 盘指定目录:

wsl --import Ubuntu-22.04 D:\WSL\Ubuntu2204 D:\WSL\ubuntu2204_szx.tar --version 2 

步骤 5:验证迁移 + 更新 Ubuntu 软件包

  1. 启动 D 盘的 Ubuntu:从开始菜单搜'Ubuntu 22.04 LTS',点击启动,会直接进入 szx 用户的终端。

更新软件包(确保环境最新,后续装工具不缺依赖):在 Ubuntu 终端输入,输完密码等待完成:

sudo apt update && sudo apt upgrade -y 

这里重点说下:因为已经迁移到 D 盘,所有下载的软件包和更新文件都会存在 D 盘的 D:\WSL\Ubuntu2204\rootfs 目录下,完全不占 C 盘空间。

验证迁移是否成功:输入以下命令,若显示 LOCATION: D:\WSL\Ubuntu2204,就说明成了:

wsl --list --verbose 

总结

最终效果

  • 成功装了 WSL 2 版本的 Ubuntu 22.04,默认用户 szx 权限正常;
  • 整个系统都在 D 盘,C 盘没增加任何占用;
  • 全程用的微软官方渠道,没碰国内镜像源;
  • 环境稳定,后续可以直接装需要的工具。

避坑重点

  1. 装 WSL 先更版本!旧版 WSL bug 多,很多报错都是因为没更新,wsl --update 一条命令就能解决;
  2. 命令别用错地方:wsl 相关命令在 PowerShell 里执行,apt 这类 Linux 命令在 Ubuntu 终端里用;
  3. 新手别瞎找 tar 包:直接用 wsl --install -d 分发版名称 一键安装,比手动导入省太多事;
  4. 迁移前必关 WSL 实例:wsl --shutdown 执行完再迁移,避免文件占用报错。

目录

  1. 核心需求
  2. 常见错误排查
  3. 坑 1:导入时直接报“未指定的错误”
  4. 坑 2:想查 WSL 版本,却提示“命令无效”
  5. 坑 3:升级 WSL 后,才发现 tar 包格式错了
  6. 坑 4:在 Ubuntu 终端里跑 Windows 命令
  7. 安装与迁移步骤
  8. 步骤 1:升级 WSL 到最新版
  9. 步骤 2:用微软官方命令一键装 Ubuntu 22.04
  10. 步骤 3:退出 Ubuntu 终端,准备迁移到 D 盘
  11. 步骤 4:把 Ubuntu 迁移到 D 盘(避免占 C 盘)
  12. 步骤 5:验证迁移 + 更新 Ubuntu 软件包
  13. 总结
  14. 最终效果
  15. 避坑重点
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Python 爬取同花顺股票数据及技术指标提取
  • 宇树 VR 遥操与 IL:从 xr_teleoperate 到 unitree_IL_lerobot 的 G1 开发实践
  • 从人类视频到机器人跳舞:BeyondMimic 全流程解析与 rl_sar 部署实践
  • C 语言实现边缘 AI 推理:量化、算子融合与内存映射实战
  • Windows WSL (Ubuntu) 安装与配置教程
  • Spring Boot 核心注解完全手册
  • FastAPI:Python 高性能 Web 框架
  • Java 全栈开发工程师面试实战:从基础到项目落地
  • MCP 插件配置指南:以 browser-tools-mcp 为例
  • 企业级Python反爬虫技术:JS逆向、APP抓包与验证码破解实战
  • Python 爬虫基础教程:豆瓣电影 Top250 数据抓取
  • 基于 FastAPI 的 Web 上位机系统设计与实现
  • OpenClaw 为何爆火?AI Agent 从技术圈走向大众场景的观察
  • Ubuntu 下安装 OpenClaw 并配置安全访问
  • 2026 年 3 月全球 AI 前沿动态:从模型突破到智能体跃迁
  • Java 基础:char、String、StringBuilder 与 StringBuffer 核心解析
  • 大学生论文 AI 写作工具优选,省时且保学术严谨性
  • CVPR 2024 论文阅读:Fusion-Mamba 跨模态目标检测
  • 滑动窗口算法结合例题详解
  • Stable Diffusion 与 Z-Image-Turbo 部署对比:推理速度与显存占用评测

相关免费在线工具

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

  • HTML转Markdown

    将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

  • JSON 压缩

    通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

  • JSON美化和格式化

    将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online