Steam Deck 上 Waydroid 的卸载与升级完整指南：安全移除 Android 环境与版本更新一步到位
【免费下载链接】SteamOS-Waydroid-InstallerScript to easily install / uninstall Android via Waydroid on the Steam Deck running on SteamOS stable, beta or MAIN!项目地址: https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer
SteamOS-Waydroid-Installer 让 Steam Deck 能流畅运行 Android 应用与游戏，但当你想安全卸载这套 Android 环境，或想升级到支持新功能的版本时，从哪下手往往让人犯难。尤其是 SteamOS 大版本更新后 Waydroid 神秘"消失"、游戏突然进不去这类状况，几乎每个用户都会撞上一次。别急，这篇指南把卸载与升级的路数一次讲透，照着做就能把 Android 环境管理得明明白白。
先回答一个问题：你此刻需要的是卸载，还是升级？
很多朋友一上来就问"怎么删"，其实在动手之前，先用 30 秒判断一下方向，能省下不少冤枉路。卸载和升级是两条完全不同的路：卸载是把 Android 环境整体搬走，升级则是在保留数据的前提下换上新版本。
| 你的现状 | 推荐动作 | 理由 |
|---|---|---|
| 很久没用 Android 功能，想腾出存储空间 | 卸载 | 系统镜像加应用数据通常能释放好几个 GB |
| 游戏打不开、反复报错，怀疑环境坏了 | 先升级，再考虑卸载重装 | 新版脚本往往已经修复了旧版问题 |
| SteamOS 更新后 Waydroid 不见了 | 重跑安装脚本（相当于升级） | SteamOS 更新会清掉 Waydroid，这是正常现象 |
| 想要假 WiFi、手柄映射、新游戏兼容等新特性 | 升级 | 项目持续更新，新功能都靠版本迭代引入 |
一个简单的判断口诀：不想再用了就卸载，还想继续用就升级；出问题了先升级试试，升级救不回来再卸载重装。想了解脚本当前支持哪些 SteamOS 版本与系统检查项，可以翻翻仓库根目录下的sanity-checks.sh，里面写得很清楚。
动手前花 10 分钟做这三件事，数据一个都不丢
卸载和升级最大的顾虑就是"我的东西会不会没了"。Waydroid 的数据主要集中在两处：Android 应用的数据与游戏存档，存放在/home/deck/.local/share/waydroid目录下；而整套自定义镜像则放在~/Android_Waydroid文件夹里。动手前按下面三步走，基本可以高枕无忧：
- 备份游戏进度：安卓游戏大多支持云存档，先在游戏里手动同步一次；单机游戏则直接拷贝存档目录。
- 备份应用数据：重要应用（比如聊天、笔记类）可以用安卓自带的备份功能，或者直接把
/home/deck/.local/share/waydroid整个目录复制到移动硬盘。 - 确认 sudo 密码：无论是卸载还是升级，脚本都会要求输入 sudo 密码验证权限，密码没设置过的话，先到桌面模式终端里执行
passwd设置一个。
另外提醒一句：SteamOS 本身是只读系统，Waydroid 的安装和移除都会临时解锁再恢复只读，全程由脚本自动完成，你只需要确保网络稳定、电量充足、磁盘剩余空间不低于 10GB 即可。
用桌面上的 Waydroid Toolbox 安全移除 Android 环境
如果你走的是图形界面路线，移除工作其实比你想象的简单——安装脚本已经在你的桌面放好了一个叫Waydroid Toolbox的工具箱，它是整个移除过程的核心入口。
双击打开工具箱，你会看到一个选项列表，里面包括 ADBLOCK（广告拦截）、AUDIO（音频）、SERVICE（服务开关）、GPU（图形设置）、LAUNCHER（启动器）、NETWORK（网络）等常用配置项，以及我们这次要找的UNINSTALL（卸载）选项。选中 UNINSTALL 后，系统会弹出 sudo 密码输入框，验证通过后脚本会自动完成一连串操作：停止 Waydroid 相关服务、移除容器与 Android 镜像、清理配置文件、把系统设置恢复原样，整个过程大约 2 到 5 分钟。
这里有个贴心的细节值得注意：工具箱提供了两种卸载粒度——一种是卸载但保留 Android 用户数据，另一种是连同用户数据一起完全移除。如果你只是暂时不用、之后还打算装回来，选前者可以省去重新折腾数据的麻烦；如果确定彻底告别，再选完全移除。移除完成后，Steam Deck 桌面上的工具箱图标可能还会残留，重启一次设备就会自动清理干净。
习惯命令行的用户：卸载也可用这几条指令完成
不习惯点图形界面的话，打开桌面模式的终端（Konsole），同样能完成移除。这三条命令按顺序执行即可：
sudo systemctl stop waydroid-container sudo waydroid session stop sudo waydroid container stop这三条命令的作用分别是：先停掉 Waydroid 的后台容器服务，再结束当前会话，最后关闭容器本体。想进一步把相关软件包也清理掉，可以补一条sudo pacman -Rns waydroid。需要说明的是，图形工具和命令行两条路最终达到的效果一致，选择哪个纯看个人习惯，对新手来说工具箱更稳妥，对熟手来说命令行更干脆。
升级不一定需要卸载：两种版本更新路径对比
好消息是，升级并不需要先卸载再安装。项目专门准备了一条保留数据的更新通道，走这条路，你的应用和存档都能原样保留。
路径一：桌面上的 Waydroid Updater 一键升级（推荐）
安装完成后，桌面除了 Waydroid Toolbox，还有一个Waydroid Updater的快捷方式。双击它，脚本会自动完成"拉取最新代码 → 重跑安装流程 → 保留现有数据"的全过程。脚本内部会检测到这是一次重装而非全新安装，从而跳过镜像下载、直接沿用你已配置好的环境，整个过程基本不用人工干预。
路径二：手动克隆最新代码重装（适合想换分支的用户）
想完全掌控更新过程，或者想体验还在测试中的新功能，可以在终端里手动操作。先打开终端，进入主目录并克隆代码：
cd ~/ git clone --depth=1 https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer这条命令的作用是从官方仓库拉取最新代码到本地。随后进入目录、赋予执行权限并运行安装脚本：
cd ~/SteamOS-Waydroid-Installer chmod +x steamos-waydroid-installer.sh ./steamos-waydroid-installer.sh这几条命令的作用是进入项目目录并启动安装脚本，脚本会自动完成后续的环境搭建。如果你属于"想尝鲜"的那类用户，可以把第一句换成带-b testing参数的命令，拉取的是测试分支——新功能会先在 testing 分支上打磨一到两周，稳定后才合并进 main 分支。
升级或卸载后翻车？四个自救方法按顺序试
操作过程中难免遇到状况，别慌，多数问题都有对应的解法。这里整理了出现频率最高的四个"翻车现场"，按顺序排查基本都能解决。
现象一：卸载后桌面图标还在。这通常是 KDE 桌面菜单缓存没刷新，重启一次 Steam Deck 就会消失；如果还在，说明手动清一下桌面的快捷方式文件即可。
现象二：升级后 Waydroid 启动不了。大概率是网络或空间问题。先确认网络通畅、/home分区剩余空间不低于 10GB，再看一眼项目目录下的 logfile 安装日志，通常错误原因就写在里面。
现象三：SteamOS 更新后 Waydroid 整个不见了。这是 SteamOS 更新机制导致的正常行为——系统更新会覆盖式写入，Waydroid 自然被清掉。解决方式很简单：重新跑一次安装脚本。唯一要注意的是，如果这次更新换了新内核，脚本可能检测到版本不匹配而直接退出，这时候需要等作者发布适配新内核的版本，或到仓库提交一个 issue 说明情况。
现象四：游戏模式里没有出现 Waydroid 快捷方式。常见原因是安装脚本是在 SSH 或虚拟终端会话里运行的，导致 Steam 客户端无法正常添加快捷方式。确保你在桌面模式的 Konsole 里运行脚本，重装一次即可解决。
算笔账：卸载能找回多少空间，升级又能带来什么
空口无凭，我们用数据说话。一次完整的卸载大约能释放这些空间：
- Android 系统镜像：约 2 至 4GB
- 应用与游戏数据：视使用情况而定，装了大型游戏的往往能到十几 GB
- 缓存与临时文件：通常在 1GB 上下浮动
也就是说，一台只装了基础应用的主机，卸载后能轻松找回 4GB 以上；常玩大型安卓游戏的话，回收的空间翻几倍都不奇怪。而选择升级的回报同样实在：项目最近几个版本引入了 libhoudini 兼容层让更多游戏可玩、假 WiFi 配置自动生效、手柄键位映射优化、广告拦截规则自动更新等改进，几乎每一版都在解决真实痛点。想知道具体版本带来了什么，翻翻 README 里的更新日志是最快的方式。
让 Android 环境长期稳定服役的三个维护习惯
卸载和升级都不是一锤子买卖，养成下面三个习惯，能让 Waydroid 一直处于健康状态：
- 每月看一眼更新：关注项目是否有新版本，发现更新后直接用 Waydroid Updater 升级即可，成本极低。
- 升级前扫一眼更新日志：重点看是否有破坏性变更，做到心中有数再动手。
- 把备份当日常：重要游戏进度随手同步云存档，比任何事后补救都省事。
另外，如果你在排查问题，可以多看两个文件：sanity-checks.sh里是脚本运行前的系统自检逻辑（版本、分区空间、sudo 密码、桌面模式等），functions.sh里则是清理与恢复相关的函数，理解了它们，你就知道脚本每一步在做什么，排查起来也更有的放矢。
现在，无论你是想给 Steam Deck 腾出空间、还是想让它解锁更多 Android 新特性，方法都已经摆在眼前了：不想用了就打开 Waydroid Toolbox 点 UNINSTALL，想更新就双击 Waydroid Updater。两分钟就能开始，别让一个吃灰的模拟环境占着宝贵的存储，也别让旧版本挡着你体验新功能。动手试试吧，你的 Steam Deck 会感谢你的。🚀
【免费下载链接】SteamOS-Waydroid-InstallerScript to easily install / uninstall Android via Waydroid on the Steam Deck running on SteamOS stable, beta or MAIN!项目地址: https://gitcode.com/gh_mirrors/st/SteamOS-Waydroid-Installer
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考