Jupyter已装BeautifulSoup4仍报No module named 'bs4'导入错误

出现该问题的核心原因是Jupyter当前运行的Python内核，和你执行pip命令时调用的Python解释器不属于同一环境。哪怕pip list显示包已经安装，内核实际加载模块时只会检索自己关联的site-packages路径，和pip装到的路径不匹配时就会触发找不到模块的报错。

注意：pip安装路径的显示逻辑，和Jupyter内核的模块检索路径是完全独立的，不能因为路径字符串看起来一致就默认二者属于同一环境。

具体排查与解决步骤 #

• 第一步：定位当前Jupyter内核实际关联的Python解释器路径
  在notebook单元格内执行以下代码，输出的路径才是内核真正加载第三方包的目标路径：
  import sys; print(sys.executable)
• 第二步：清理冲突的冗余包
  你当前pip列表里的bs4 0.0.1是无实际功能的第三方空包，并非BeautifulSoup的官方模块，会和正式包产生导入冲突，直接执行卸载：
  !{sys.executable} -m pip uninstall -y bs4
• 第三步：匹配对应环境安装正式依赖
  不要直接使用!pip3 install BeautifulSoup4的写法，而是调用内核自身的pip工具安装，从根源上避免路径错位：
  !{sys.executable} -m pip install beautifulsoup4
  安装完成后再执行from bs4 import BeautifulSoup即可正常导入。

可选适配方案 #

如果需要让Jupyter复用你之前在外部环境安装好的所有依赖，不需要在notebook中重复装包，可以给对应Python环境注册专属Jupyter内核：

1. 找到你外部已经安装好BeautifulSoup的Python解释器绝对路径
2. 在终端执行对应命令安装ipykernel：你的Python解释器路径 -m pip install ipykernel
3. 注册内核到Jupyter：你的Python解释器路径 -m ipykernel install --user --name 自定义内核名称
4. 回到Jupyter的内核选择列表，切换到刚注册的专属内核即可正常加载所有外部已安装的包。

日常使用技巧：在Jupyter中安装包时，统一使用!{sys.executable} -m pip install 包名的写法，不要直接调用全局的pip/pip3命令，可避免90%以上的多Python环境错位导致的ModuleNotFoundError。

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