distlib 是 QEMU 9.2.4 的属性,不是某个 runner 的 —— 两个宿主上量出来才这么叫

符号链接那条修好了:Windows 的 fetch 现在通过。configure 接着倒在与 macOS 完全
相同的一行上:

    *** Ouch! ***
    found no usable distlib, please install it

⚠️ 第一轮我只在 macOS 上修了它,理由是「Homebrew 的 Python 比较特别」。Windows 这
条腿走到同一行,说明它不特别 —— QEMU 的 mkvenv 需要 distlib,而现代 Python 都不
自带。注释按两宿主的事实重写。

MSYS2 侧优先用 pacman 的包、回落到 pip:前者是 MSYS2 用户手里会有的东西,后者保证
这个包被改名时这一步仍然可用。

Author: speak-agent

.github/workflows/build.yml

@@ -84,16 +84,21 @@ jobs:
         if: runner.os == 'macOS'
         run: |
           brew install ninja meson pkg-config glib pixman
-          # ⚠️ `distlib`, AND IT IS NOT AN OPTIONAL EXTRA. QEMU's `configure`
-          # builds a non-isolated virtual environment with its own `mkvenv`
-          # script, which needs `distlib` to populate it. Homebrew's Python 3.14
-          # does not carry it, and the failure is a configure-time
+          # ⚠️ `distlib`, AND IT IS A PROPERTY OF QEMU 9.2.4 RATHER THAN OF THIS
+          # RUNNER — MEASURED ON TWO HOSTS BEFORE IT WAS CALLED THAT.
+          #
+          # QEMU's `configure` builds a non-isolated virtual environment with its
+          # own `mkvenv` script, which needs `distlib` to populate it. Neither
+          # Homebrew's Python 3.14 nor MSYS2's carries it, and the failure is a
+          # configure-time
           #
           #     *** Ouch! ***
           #     found no usable distlib, please install it
           #
           # twenty seconds in, which reads like a QEMU problem and is a Python
-          # packaging one.
+          # packaging one. The first round fixed it on macOS alone, on the
+          # reading that Homebrew was unusual; the Windows leg then reached the
+          # same line and showed it was not.
           #
           # `--break-system-packages` because Homebrew's Python is
           # externally-managed (PEP 668) and refuses otherwise. On a throwaway
@@ -157,6 +162,19 @@ jobs:
       # `roms/` stays excluded regardless: it holds firmware SOURCE for machines
       # this build does not produce, and `x86_64-softmmu` takes its firmware
       # from the prebuilt blobs in `pc-bios/`.
+      # The same `distlib` gap as macOS, on MSYS2's Python. Preferring the
+      # packaged form and falling back to pip: pacman's copy is what an MSYS2
+      # user would have, and pip is what makes the step work if that package is
+      # ever renamed.
+      - name: distlib (Windows / MSYS2)
+        if: runner.os == 'Windows'
+        shell: msys2 {0}
+        run: |
+          pacman -S --noconfirm --needed mingw-w64-ucrt-x86_64-python-distlib \
+            || python3 -m pip install --break-system-packages distlib \
+            || python3 -m pip install distlib
+          python3 -c "import distlib; print('distlib', distlib.__version__)"
+
       - name: Fetch QEMU ${{ env.QEMU_VERSION }} (Windows)
         if: runner.os == 'Windows'
         shell: msys2 {0}