VS Code Jupyter Notebook无法识别全局安装的Python模块

可能的原因及解决步骤： #

1. Jupyter内核与所选解释器不匹配
   VS Code右上角选择的解释器仅为UI层面关联，实际Jupyter内核可能仍指向其他环境。在Notebook中执行以下代码，确认当前内核的Python路径：

import sys
print(sys.executable)

若输出路径与/usr/local/bin/python3不一致，说明内核未正确关联：

• 在VS Code终端执行命令，将全局解释器注册为Jupyter内核：

  python3 -m ipykernel install --user --name=python3.7.9
  

• 重启Notebook，在右上角选择刚注册的python3.7.9内核。

2. pip3与python3的关联异常
   即使which命令显示路径一致，仍可能存在隐藏的环境冲突。执行以下命令验证模块列表是否匹配：

python3 -m pip list

若输出与pip3 list不一致，说明pip3未关联当前python3：

• 后续安装模块改用python3 -m pip install <模块名>，确保安装到目标解释器的site-packages目录；
• 检查~/.bash_profile或~/.zshrc中的PATH配置，确保/usr/local/bin处于PATH最前端，避免环境优先级混乱。

3. VS Code Python扩展缓存问题
   VS Code的Python扩展可能缓存旧的模块信息，导致无法识别新安装的模块：

• 按下Cmd+Shift+P打开命令面板，执行Python: Refresh IntelliSense刷新模块索引；
• 重启VS Code后重新加载Notebook。

4. 全局安装权限问题
   Mac系统下全局安装模块可能因权限限制，导致模块安装到仅root可访问的目录，普通用户运行的Jupyter无法读取：

• 执行命令查看模块安装路径：

  python3 -c "import librosa; print(librosa.__file__)"
  

• 若路径位于/Library/Python/3.7/site-packages等需root权限的目录：
  • 改用python3 -m pip install --user <模块名>重新安装，将模块部署到用户目录~/.local/lib/python3.7/site-packages；
  • 或给全局site-packages目录添加读取权限：

    sudo chmod -R a+r /usr/local/lib/python3.7/site-packages
    

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