Files
iomgaa 72cfba5996 docs(guides): 补上验 sdist 那条命令的完整形状,以及漏掉 --no-build-isolation 的坑
第八步原来只说「sdist 要单独取,加 --no-binary :all:」,没给完整命令。照着上一条 pip
download 拼出来的那条**跑不通**,这是发 1.0.2 时实测撞上的。

原因是 --no-binary :all: 让 pip 取 sdist 之后会去构建它的元数据,而构建要先装
build-system.requires 里那个 setuptools——而 --index-url 已经把索引整个换成了这个 registry,
那儿只有 polyloop。报出来的是「Failed to build 'polyloop' when installing build
dependencies」,读起来像刚传上去的包坏了,实际上包好好的、坏的是命令的索引配置。这个失败
形态指向错误的方向,所以值得单独记一段。

--no-build-isolation 用当前 conda 环境里已经装着的 setuptools(dev 那组的 build 带着它),
不去索引找。跳过构建隔离不影响这一步的判据:这里验的是 registry 上那份 sdist 的内容,不是
「下游能不能从源码构建它」——真要验后者,索引那一项得写成 --extra-index-url。

补进去的命令逐字实测过,PKG-INFO 9566 字符,与文档里写的数字一致。
2026-08-27 05:44:54 -04:00
..