MacOS下VS Code使用Jupyter Notebook遇notebookapp导入错误

问题核心原因 #

你的环境存在多版本不兼容问题：

• VS Code 1.64.0（2022年版本）不支持Python 3.12.1（2023年发布）
• 旧版Jupyter/Python扩展与Python 3.12、arm64架构的Mac不兼容
• pyzmq 依赖未适配arm64架构，导致native build找不到

分步解决方案 #

1. 更新VS Code到最新版本
   打开VS Code，点击左下角设置图标 → 检查更新，安装最新稳定版。新版本对arm64 Mac和Python 3.12的兼容性做了完善支持。

2. 更新VS Code扩展
   打开扩展面板（快捷键 Cmd+Shift+X），找到Python和Jupyter扩展，点击「更新」按钮安装最新版本。

3. 重新安装Jupyter及依赖，修复arm64架构问题
   在终端执行以下命令：

   # 卸载现有冲突依赖
   pip3 uninstall -y jupyter pyzmq
   # 从源码编译安装，适配arm64
   pip3 install jupyter pyzmq --no-binary :all:
   

   --no-binary :all: 参数会强制从源码编译pyzmq，解决arm64平台下的native build缺失问题。

4. 验证Jupyter独立运行能力
   在终端执行：

   python3 -m notebook
   

   若能正常打开Jupyter Notebook网页，说明核心环境已修复，再回到VS Code尝试运行代码。

5. 确认VS Code的Python解释器配置
   按 Cmd+Shift+P，输入「Python: Select Interpreter」，选择 /usr/local/bin/python3（Python 3.12.1）作为当前环境的解释器。

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