https://before80.github.io/prgms/tools/uv/reference/troubleshooting/Recent content in 5.6 故障排查 on 编程那些事儿Hugozh-cnFri, 25 Sep 2026 21:01:20 +0800https://before80.github.io/prgms/tools/uv/reference/troubleshooting/5.6.1-build-failures/Fri, 25 Sep 2026 19:02:24 +0800https://before80.github.io/prgms/tools/uv/reference/troubleshooting/5.6.1-build-failures/<blockquote> <p>原文链接: <a href="https://docs.astral.sh/uv/reference/troubleshooting/build-failures/">https://docs.astral.sh/uv/reference/troubleshooting/build-failures/</a></p> </blockquote> <h1 id="561-构建失败">5.6.1 构建失败</h1> <p>当没有兼容的 wheel（包的预构建分发）可用时，uv 需要构建包。构建包可能因许多原因失败，其中一些可能与 uv 本身无关。</p> <h2 id="识别构建失败">识别构建失败</h2> <p>在新版、不受支持的 Python 版本上尝试安装旧版 numpy 可以产生一个构建失败示例：</p>https://before80.github.io/prgms/tools/uv/reference/troubleshooting/5.6.2-reproducible-examples/Fri, 25 Sep 2026 19:02:24 +0800https://before80.github.io/prgms/tools/uv/reference/troubleshooting/5.6.2-reproducible-examples/<blockquote> <p>原文链接: <a href="https://docs.astral.sh/uv/reference/troubleshooting/reproducible-examples/">https://docs.astral.sh/uv/reference/troubleshooting/reproducible-examples/</a></p> </blockquote> <h1 id="562-可复现示例">5.6.2 可复现示例</h1> <h2 id="为什么可复现示例很重要">为什么可复现示例很重要</h2> <p>最小可复现示例（MRE）对修复缺陷至关重要。没有能用来复现问题的示例，维护者就无法调试它，也无法测试它是否被修复。如果示例不是最小的，也就是说它包含大量与问题无关的内容，维护者识别问题根因所需的时间会大大增加。</p>