如何重置Mac上多版本Python与Jupyter的安装配置？

问题核心分析 #

从错误日志看，Jupyter实际调用的是Python3.9（而非你安装的3.11/3.12），且该环境下的zmq库Cython后端未正确编译，导致内核启动失败。这是多Python版本残留、环境关联混乱引发的问题。

分步解决步骤 #

1. 彻底清理残留的Python3.9 #

• 用brew卸载旧版本：

  brew uninstall python@3.9
  

• 删除残留的site-packages目录：

  sudo rm -rf /usr/local/lib/python3.9
  

• 删除相关可执行文件链接：

  sudo rm -rf /usr/local/bin/python3.9 /usr/local/bin/pip3.9
  

2. 切换并锁定目标Python版本（以3.12为例） #

• 查看brew已安装的Python版本：

  brew list | grep python
  

• 解除现有Python链接，重新关联3.12：

  brew unlink python@3.11 && brew link python@3.12 --force
  

• 验证版本是否正确：

  python --version  # 应显示Python 3.12.x
  pip --version     # 应对应Python 3.12的pip
  

3. 重新安装Jupyter到目标环境 #

• 先卸载所有旧的Jupyter相关包：

  pip uninstall -y jupyter jupyterlab ipykernel pyzmq
  

• 重新安装完整Jupyter环境：

  pip install jupyter jupyterlab
  

• 将当前Python版本注册为Jupyter内核：

  python -m ipykernel install --user --name=python3.12 --display-name="Python 3.12"
  

4. 测试Jupyter运行 #

• 启动Jupyter Notebook：

  jupyter notebook
  

• 新建笔记本时选择Python 3.12内核，运行测试代码：

  print("Jupyter运行正常")
  

额外注意事项 #

• 避免手动删除/usr/local/lib、opt下的文件，这类操作容易破坏brew的依赖管理，优先用brew uninstall/brew cleanup清理。
• 若使用Anaconda，需确保Anaconda的Python环境与系统brew环境隔离，可通过conda create -n py312 python=3.12创建独立环境，再在该环境内安装Jupyter。

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