1. 先理解：QEMU 是什么？QEMU（Quick Emulator）是开源的硬件模拟器，能让你在一种 CPU 架构的电脑上运行另一种架构的操作系统。一句话："想玩别的电脑/架构，又不想真买一台"时的软件模拟器。它有两种工作模式：模式干什么典型命令系统模拟System Emulation模拟整台电脑（CPU+内存+磁盘+外设），能运行完整操作系统qemu-system-aarch64用户模式模拟User-mode Emulation只翻译单个程序的指令，没有独立系统qemu-aarch64打个比方：系统模拟 = 租一整间办公室：房间、桌椅、水电全都要，才能办公——成本高、速度慢用户模式模拟 = 只招一个人：一个人自带技能进场干活——轻量、快本文用的是系统模拟：把 GitHub Actions 构建出的 IoT2050 镜像（.wic磁盘 + 内核 + initrd）整机启动，串口 + SSH 验证 Debian 示例系统。注意：QEMU 镜像不能当 Docker 镜像跑。QEMU 是整机虚拟化，Docker 是进程级隔离，两者是不同类型的产物。本文全程用 QEMU 模拟器，不需要本地 Docker。2. 前置条件项目要求WindowsWin11，已装 WSL2（含 Ubuntu 发行版，wsl -d Ubuntu可进入）GitHub已有siemens/meta-iot2050的 Fork网络WSL2 能上网（apt 安装 QEMU 需要）磁盘镜像约 2~5 GB，WSL2 所在盘留 10 GB 以上3. 第一步：让 GitHub Actions 产出 QEMU 镜像3.1 关键坑：官方 workflow 默认不下载 QEMU 产物！你 Fork 的meta-iot2050仓库里，.github/workflows/main.yml的debian-example-qemu-imagejob只有 Build 步骤，没有 upload-artifact 步骤（example image 和 swupdate 都有，唯独两个 QEMU job 没有）。也就是说：直接触发构建，产物只存在于云端 runner，无法从 Actions 页面下载。解决办法：在你自己 Fork 的 main.yml 里给 QEMU job 加一段上传代码（改自己的 fork，不影响官方仓库）。打开你的 Fork：https://github.com/你的账号/meta-iot2050/blob/master/.github/workflows/main.yml⚠️ 注意分支是master，不是main（官方仓库默认分支就是 master