必须用 python -m pip install --upgrade pip setuptools wheel：因直接运行 pip upgrade 可能锁住自身文件致升级失败，而 python -m pip 绕过二进制调用更安全；缺 wheel 会报“找不到构建后端”，setuptools 过低也会引发问题。
这是 pip 工具链太老，不是包有问题，也不是网络或权限问题——优先升级 pip、setuptools 和 wheel。
为什么必须用 python -m pip install --upgrade pip setuptools wheel
直接运行 pip install --upgrade pip 时，正在被调用的 pip 可能正锁着自己的文件，导致升级不完整甚至损坏。而 python -m pip 是绕过当前 pip 二进制，用 Python 解释器直接调用模块，更安全可靠。
缺 wheel 会触发“找不到构建后端”类报错；setuptools 版本太低（比如 pyproject.toml 中的 [build-system] 配置，遇到 pandas、scikit-learn 等新包必然失败。
- 执行前先确认环境：运行
which pip（macOS/Linux）或where pip（Windows），看路径是否指向你当前想操作的虚拟环境 - 输出
pip --version，确保版本 ≥ 23.3；低于这个数，大概率踩坑 - conda 环境下别用 pip 升级 pip，改用
conda update pip，否则可能破坏 conda 的元数据一致性
升级后还报错？先清缓存再重试
损坏的缓存 wheel 会反复让 pip 尝试加载旧的、解析失败的元数据，形成死循环。这不是“重装就能好”，而是缓存污染了构建流程。
从QuickView趋势笔记生成韩语AI播客包，含双人主持脚本（Callie×Nick）、Gemini多说话人TTS音频、字幕时间轴与渲染修正、缩略图+MP4包装及YouTube标题/描述输出。支持完整版（15~20分钟）和压缩版（5~7分钟）。
- 运行
pip cache purge彻底清空本地缓存 - 加
--no-cache-dir强制跳过缓存：pip install pandas --no-cache-dir - 如果公司内网受限，加镜像源：
pip install --no-cache-dir -i https://pypi.tuna.tsinghua.edu.cn/simple/ pandas
某些包（如 spflow、pyqt6-tools）单独报错怎么办
不是工具链问题，是包本身配置有缺陷或生态脱节。比如 spflow 的 pyproject.toml 错把 sklearn（一个占位空包）写成依赖，pip 一解析就崩；pyqt6-tools 则是因为官方还没发布适配你当前 Python 版本（比如 3.12 或 3.13）的预编译 wheel，pip 只能退回去源码编译，但你没装 Qt C++ 工具链。
- 对
spflow这类：临时加--no-deps跳过依赖检查，或手动编辑requirements.txt把sklearn换成scikit-learn - 对
pyqt6-tools这类：去 PyPI 文件页 手动下载匹配你 Python 架构（win-amd64 / manylinux / macosx）和版本（cp312 / cp313）的.whl文件，再pip install xxx.whl - 极少数情况是
setuptools太新反而出问题（如某些Xinference版本），可降级：pip install setuptools==65.5.0
PyCharm 里点安装按钮失败，和终端命令不是一回事
PyCharm 默认用自己封装的 pip 调用逻辑，不读系统 PATH，也不继承你在终端刚升级的 pip。它可能还在用旧版 pip，或者压根没激活项目对应的虚拟环境。
- 进
File → Settings → Project → Python Interpreter，点右下角齿轮 →Upgrade pip，这是 PyCharm 官方推荐路径 - 如果点了没反应，说明 PyCharm 没权限写入该环境，得手动在 Terminal 里激活对应 venv：
source venv/bin/activate（macOS/Linux）或venv\Scripts\activate（Windows），再跑升级命令 - PyCharm 的 Terminal 默认不自动激活项目解释器，这点很多人忽略，结果在 base 环境里升级，却想装进 venv
真正卡住人的从来不是“要不要升级”，而是升级后 pip 绑定的是哪个 Python、写入的是哪个 site-packages、读取的是哪个 cache 目录——路径错一位，metadata-generation-failed 就会反复出现。
