答案是升级 pip 和 setuptools。该错误主因是工具链过旧，无法解析 pyproject.toml 和 pep 517 构建的包元数据，升级后可启用健壮构建隔离机制并正确读取配置。
这是 pip 工具链太老，不是包的问题，也不是网络或权限问题。 你看到的 metadata-generation-failed 错误，90% 以上都源于 pip 或 setuptools 版本过低，无法解析现代 Python 包（尤其是用 pyproject.toml + PEP 517 构建的）的元数据结构。
为什么升级 pip 和 setuptools 是第一要务
旧版 pip（build-system.requires 字段，遇到新版 numpy、pandas、scikit-learn 就会卡在元数据生成阶段；setuptools pyproject.toml 里的配置读错，甚至误判“没有 setup.py”而直接退出。
- 必须用
python -m pip install --upgrade pip setuptools wheel—— 直接跑pip install --upgrade可能因 pip 正在被调用而失败 -
wheel不是可选：它是构建过程的底层依赖，缺了会报 “no build backend found” - 升级后运行
pip --version，确认输出里带 Python 路径，且pip≥ 23.3、setuptools≥ 68.0（若装了scikit-learn或mxnet，建议 ≥ 69.5）
升级后还报错？先清缓存再重试
损坏的缓存 wheel 会反复触发元数据解析失败，尤其在多次升级/降级后。
TikTok Creator Pipeline
下载
TikHub API 多平台数据爬取工具，支持抖音/TikTok/B站等。用户提及以下需求时调用：1) 爬取视频或评论；2) 获取用户信息/粉丝列表；3) 批量下载无水印视频；4) 抖音链接转文字（下载→音频→Whisper pipeline）；5) 调用 TikHubAPI。
- 执行
pip cache purge彻底清空本地缓存 - 安装时加
--no-cache-dir：比如pip install pandas --no-cache-dir - 如果公司内网受限，加镜像源：例如
-i https://pypi.tuna.tsinghua.edu.cn/simple/ - 避免用
easy_install或手动运行get-pip.py—— 它们在 Python 3.12+ 中已失效，会引发ImportError: cannot import name 'main'
某些包有特殊依赖陷阱
不是所有 metadata-generation-failed 都是工具链问题。有些包自身配置就有坑：
-
spflow的setup.py错把sklearn（非官方占位包）当依赖，应手动替换为scikit-learn -
PyQt5-tools或PyQt6-tools报错含qmake，说明系统没装 Qt 构建工具，得先装qt5-default（Ubuntu）或把qmake加进PATH -
mxnet报错常因numpy初始化失败，可先pip install --no-deps mxnet绕过依赖检查 - 某些包（如
Xinference）与新版setuptools冲突，临时降级：pip install setuptools==65.5.0
PyCharm 里点安装却失败？它根本没用你刚升级的 pip
PyCharm 默认调用自己的封装逻辑，不继承终端 PATH，也不感知你刚在 shell 里升级的 pip。
- 进
File → Settings → Project → Python Interpreter，右下角齿轮 →Upgrade pip - 如果没反应，说明 PyCharm 没写入权限 —— 得先在 Terminal 里激活对应虚拟环境：
source venv/bin/activate（macOS/Linux）或venv\Scripts\activate（Windows），再跑升级命令 - PyCharm 的 Terminal 默认不自动激活项目解释器对应的 venv，这点极易忽略
真正容易卡住的，从来不是“该不该升级”，而是升级后 pip 拿到的是哪个 Python、哪个 setuptools、哪个缓存路径 —— 多数人只看命令是否成功，不验证实际生效的版本和路径。
