MemRelay/projects/d5a7f581-c442-4554-87b9-ee723b8b0258/坑：离线 wheel 下载的平台标签与 sdist 特例.md

title, type, permalink, stable_id, scope, project_id, memory_type, status, revision, restored_from_commit, created_at, updated_at, tags

title	type	permalink	stable_id	scope	project_id	memory_type	status	revision	restored_from_commit	created_at	updated_at	tags
坑：离线 wheel 下载的平台标签与 sdist 特例	experience	main/projects/d5a7f581-c442-4554-87b9-ee723b8b0258/坑离线-wheel-下载的平台标签与-sdist-特例	2bff13bb-b5cc-40fd-8b2f-774f5c6b9dba	project	d5a7f581-c442-4554-87b9-ee723b8b0258	experience	active	1	6a6a895eaf	2026-09-23T15:10:11.097796+00:00	2026-09-23T15:10:11.097857+00:00	pitfall pypi wheel

pypi_mirror.py download 用 --only-binary + --platform manylinux_2_17_x86_64：1) 个别包（如 watchdog）wheel 只标 manylinux2014_x86_64 无 2_17 复合别名，整批解析失败且 pip 是 all-or-nothing——遇批量失败先拆批定位，再单独 pip download --platform manylinux2014_x86_64。2) 只发 sdist 的包（如 peewee）：pip download --no-binary 会在本机触发 PEP517 构建（Windows 无编译器失败），改从 PyPI JSON API（https://pypi.org/pypi//json 的 urls 里 packagetype=sdist）直接拓 tar.gz；upload 已支持 .tar.gz，pypiserver 原生支持 sdist，容器内安装时纯 Python 包可现场构建。3) pysftp 类 sdist-only 且有替代（paramiko）的直接不收录。