
pip download 对某些包(如 dbus-python)默认尝试从源码构建 wheel,导致依赖失败;根本原因是缺少 wheel 包且未启用二进制分发优先策略,正确做法是确保 wheel 已安装并配合 --only-binary=:all: 强制跳过构建。
`pip download` 对某些包(如 `dbus-python`)默认尝试从源码构建 wheel,导致依赖失败;根本原因是缺少 `wheel` 包且未启用二进制分发优先策略,正确做法是确保 `wheel` 已安装并配合 `--only-binary=:all:` 强制跳过构建。
pip download 的设计目标是下载可离线安装的包文件(.whl 或 .tar.gz),但当目标包没有提供预编译的 wheel 文件、或本地环境未配置为优先使用二进制分发时,pip 会退回到源码构建流程——这正是你看到 Preparing metadata (pyproject.toml) ... error 和 Dependency "glib-2.0" not found 的原因:dbus-python 是 C 扩展包,其源码构建需系统级依赖(如 glib-2.0、dbus-1 开发头文件),而你的开发机并不需要编译,只需下载现成的 wheel。
✅ 正确解决方案分两步:
1. 确保 wheel 包已安装(关键前提)wheel 是 pip 构建和识别 wheel 格式的基础支持包。若未安装,pip 可能忽略 .whl 文件或无法生成临时 wheel:
pip install --upgrade pip wheel setuptools
⚠️ 注意:无需新建虚拟环境也能修复(原答案中创建 venv 是间接手段,非必要)。直接升级当前环境的
wheel即可生效。
Deepgram Nova STT Pipeline下载使用Deepgram Nova-2 API通过流式WebSocket连接进行实时语音转文本。通过Deepgram Python SDK支持说话人分离、标点符号和语言检测,适用于播客和会议转录工作流程。
2. 强制仅下载二进制 wheel,禁用源码构建
使用 --only-binary=:all: 参数明确告诉 pip:“只接受 wheel,绝不构建源码”:
pip download dbus-python --no-deps --only-binary=:all:
如果该命令报错 Could not find a version that satisfies the requirement,说明 PyPI 上暂无适配你平台(如 manylinux、win_amd64、macosx)的预编译 wheel。此时可尝试:
- 指定兼容平台(例如在 x86_64 Linux 上下载通用 manylinux wheel):
pip download dbus-python --no-deps --only-binary=:all: --platform manylinux2014_x86_64 --abi cp39 --implementation cp
- 或改用
pip download --no-deps --prefer-binary(较新 pip 版本支持,更柔和的二进制优先策略)。
? 补充建议:
- 离线部署前,建议先用
pip show dbus-python查看目标服务器 Python 版本与架构,确保下载的 wheel 兼容(可通过pip debug --verbose获取tags信息); - 若
dbus-python确实无官方 wheel(当前 PyPI 中确实仅提供 source tarball),则必须在目标服务器同环境中预先构建 wheel(如用pip wheel --no-deps --wheel-dir ./wheels dbus-python),再将./wheels/整体复制过去安装。
总结:pip download 构建行为源于缺失 wheel + 缺乏二进制约束。修复核心是 pip install wheel + --only-binary=:all:,而非依赖虚拟环境——简洁、可靠、符合现代 pip 最佳实践。


















