根本原因是pip安装环境与python运行环境不一致；需通过pip -V和python -c "import sys; print(sys.executable)"比对路径是否完全相同，尤其site-packages和python可执行文件路径。
根本原因只有一个：你 pip install 的 Python 环境，和你运行 python 或 import 的 Python 环境，压根不是同一个。
怎么确认 pip 和 python 是不是同一个环境
别猜，直接查。在终端里依次执行：
pip -V<br>python -c "import sys; print(sys.executable)"
两行输出里的路径必须完全一致，尤其是 site-packages 所在目录和 bin/python（或 Scripts\python.exe）路径。哪怕只差一个字符（比如 python3.9 vs python3.10），就代表你在往 A 环境装包，却在 B 环境跑代码。
- 如果用 conda，先
conda activate myenv，再检查which pip和which python - 如果用 virtualenv，确保
source venv/bin/activate（Linux/macOS）或venv\Scripts\activate（Windows）已执行 - Jupyter 用户额外注意：
jupyter kernelspec list查看当前 kernel 路径，它可能和终端里激活的环境不一致
为什么 pip show 能看到包，import 却报错
pip show 只告诉你“某个 pip 工具”把包装到了哪，但它不保证这个 pip 就是你当前 shell 里默认的那个。常见陷阱包括：
立即学习“Python免费学习笔记（深入）”；
librosa Python 音频与音乐分析库
下载
librosa 是一个用于音频和音乐分析的 Python 库。它提供了特征提取、频谱分析、节拍跟踪、起始检测和音频可视化的工具，基于 NumPy 和 SciPy 构建，用于科学音频计算。
- 系统自带的
/usr/bin/pip和用户安装的~/miniconda3/bin/pip共存，PATH 顺序导致调用错位 - VS Code 终端自动激活了某个环境，但调试器（debugger）用的是另一个解释器
- PyCharm 设置了项目 interpreter，但 Terminal 里没同步激活，
pip install实际装进了系统 Python - 存在同名文件干扰，比如当前目录下有个
requests.py，Python 会优先导入它而不是第三方requests包
临时修复：让 import 找到包的三种方式
这不是长期方案，但能快速验证是不是路径问题：
- 在代码开头加：
import sys; sys.path.insert(0, "/path/to/site-packages")（路径来自pip show xxx的Location:字段） - 运行时指定 Python 解释器全路径：
/full/path/to/python myscript.py，避免 PATH 混乱 - 用
-m方式运行：python -m pip install xxx和python -m mypackage.main，强制使用同一解释器
注意：sys.path.append() 放太晚（比如 import 之后）无效；export PYTHONPATH 对已启动的进程无影响，需新开终端。
自己写的模块 import 失败，和第三方包不是一回事
第三方包装在 site-packages，靠 Python 自动发现；你自己写的模块，默认只从“入口脚本所在目录”开始找。比如：
- 你在
project/a/b/main.py里写import utils，Python 只会在project/a/b/下找utils.py，不会自动向上翻到project/ - 解决方法只有三个：
cd project && python -m a.b.main（让入口变成包）、用sys.path.append("..")、或把项目pip install -e .成为可导入包 - 绝对路径导入（
from mypkg.sub import mod）要求每个中间目录都有__init__.py，且启动点必须在能覆盖整个包结构的位置
最常被忽略的一点：错误信息里说“找不到 xxx”，不等于你要去装 xxx——先分清它是第三方库，还是你本地没放对位置的自定义模块。
