本质是环境错位或安装不完整，常见于pip与python指向不同解释器；python 3.12+需升级pip≥23.3、setuptools≥67.0.0，再用清华源安装numpy==2.0.1，并验证导入路径与版本。
pip install numpy 报 “No module named 'numpy'” 却显示安装成功
本质是环境错位或安装不完整。常见于：pip 和 python 指向不同解释器，比如系统 Python 装了 numpy，但你用的是 python3.12 或虚拟环境运行代码。
- 先确认当前 Python 解释器路径：
which python（macOS/Linux）或where python（Windows） - 再查该解释器对应的 pip 是哪个：
python -m pip --version—— 必须用python -m pip，不能只敲pip - 安装时强制绑定：
python -m pip install numpy==2.0.1（Python 3.12+ 推荐） - 检查是否真装进去了：
python -c "import numpy; print(numpy.__version__)"
安装时卡住、报 ReadTimeoutError 或 Failed building wheel
这是 Python 3.12+ 用户最常遇到的组合问题：PyPI 缺少预编译包 + pip/setuptools 版本太旧 + 网络不稳定。
Ai Podcast Pipeline
下载
从QuickView趋势笔记生成韩语AI播客包，含双人主持脚本（Callie×Nick）、Gemini多说话人TTS音频、字幕时间轴与渲染修正、缩略图+MP4包装及YouTube标题/描述输出。支持完整版（15~20分钟）和压缩版（5~7分钟）。
- 必须先升级工具链：
python -m pip install --upgrade pip setuptools wheel（pip ≥ 23.3，setuptools ≥ 67.0.0） - 国内用户务必加镜像源：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple numpy==2.0.1 - 如果仍失败，直接下载
.whl文件手动装：去 清华 PyPI 镜像页 找含cp312（对应 Python 3.12）和平台标识（如win_amd64、macosx_12_0_arm64）的文件 - Mac M1/M2 用户尤其注意别下错架构，
arm64包装到x86_64环境会报incompatible architecture
装完 import 报 RuntimeError: The current Numpy installation fails to pass a sanity check
这是 Windows 上经典兼容性报错，多见于旧版 numpy（如 1.19.x）搭配新版 Python 或 Anaconda 环境，底层 Windows 运行时有 bug。
- 不要硬扛，直接换版本：
pip uninstall numpy && pip install numpy==1.26.4（适配 Python 3.9–3.12）或numpy==2.0.1（适配 Python 3.9–3.13） - 若用 Anaconda，优先走 conda：
conda install numpy=2.0.1，它自带 BLAS 优化且更稳 - 避免混用 pip 和 conda 安装同一库，conda 环境里 pip 装的 numpy 可能被 conda 的依赖解析机制破坏
scipy / matplotlib / onnx 等库报 numpy 版本冲突
不是 numpy 自身装不了，而是其他库对 numpy 有明确范围约束。例如 scipy 1.7.3 要求 numpy>=1.16.5,，而你装了 <code>numpy 2.0.1 就会拒绝启动。
- 先看报错里具体哪条依赖不满足，比如
scipy requires numpy - 降级 numpy 是最快解法：
pip install numpy==1.23.5（选上限略低的稳定版） - 或者升 scipy：
pip install --upgrade scipy（新 scipy 通常支持 numpy 2.x） - 临时隔离方案：为特定项目建干净虚拟环境，再按需装兼容组合，比全局调版本更安全
python -m 前缀，就可能把 numpy 装进完全无关的目录。
