根本原因是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 里默认的那个。常见陷阱包括：
- 系统自带的
/usr/bin/pip和用户安装的~/miniconda3/bin/pip共存，PATH 顺序导致调用错位 - VS Code 终端自动激活了某个环境，但调试器（debugger）用的是另一个解释器
- PyCharm 设置了项目 interpreter，但 Terminal 里没同步激活，
pip install实际装进了系统 Python - 存在同名文件干扰，比如当前目录下有个
requests.py，Python 会优先导入它而不是第三方requests包
临时修复：让 import 找到包的三种方式
这不是长期方案，但能快速验证是不是路径问题：
librosa Python 音频与音乐分析库
下载
librosa 是一个用于音频和音乐分析的 Python 库。它提供了特征提取、频谱分析、节拍跟踪、起始检测和音频可视化的工具，基于 NumPy 和 SciPy 构建，用于科学音频计算。
- 在代码开头加：
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——先分清它是第三方库，还是你本地没放对位置的自定义模块。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
