Python导入名与包名不匹配：如何确定对应安装包？

当你遇到import yaml却执行pip install yaml报错ERROR: No matching distribution found for yaml时，正确的安装包是pyyaml，执行pip install pyyaml即可解决。这类导入名和包名不一致的情况很普遍，比如import cv2对应opencv-python、import PIL对应Pillow，下面是几种通用解决思路：

• 优先查看项目依赖文件：项目根目录的requirements.txt、pyproject.toml、setup.py或setup.cfg里，会明确列出需要安装的包名，这是最直接的方式
• 利用PyPI搜索：直接搜索模块的导入名（比如搜“python yaml import”），搜索结果里的包详情页通常会标注对应的导入方式；也可以使用第三方工具pypi-search来查询
• 查看模块官方文档：如果知道模块的功能定位，去PyPI找到相关包，查看文档中的安装和导入说明
• 临时验证（若能导入模块）：如果已经能成功导入模块，可通过模块名.__file__找到模块文件位置，再结合pip show命令反查对应的包名；Python 3.8+也可以用importlib.metadata模块，比如执行import importlib.metadata; print(importlib.metadata.distribution('pyyaml').name)来确认包与模块的对应关系

关于PEP规范与命名约定 #

PEP 8（Python代码风格指南）只建议包名和导入名尽量保持一致，减少使用者的混淆，但并没有强制要求。导致二者不一致的原因很多：有的是历史遗留问题（比如Pillow是原PIL库的分支，保留了PIL的导入名）；有的是为了避免命名冲突；还有的是为了明确包的定位（比如opencv-python明确是OpenCV的Python绑定，导入时用更简洁的cv2）。

内容的提问来源于stack exchange，提问作者michuhu