Mac M1安装Jupyter Notebook报错Failed building wheel for argon2-cffi

问题根因 #

报错核心原因是Apple芯片架构的Mac上安装的Xcode Command Line Tools为x86_64版本，和当前系统架构不匹配，导致编译argon2-cffi依赖时clang调用失败，无法生成对应wheel包。

解决步骤 #

• 第一步：卸载现有不兼容的Xcode Command Line Tools
  终端执行命令：

  sudo rm -rf /Library/Developer/CommandLineTools
  

• 第二步：重新安装对应架构的Command Line Tools
  终端执行命令：

  xcode-select --install
  

  按照弹窗指引完成安装即可，若弹窗提示无法找到软件源，可直接前往Apple开发者官网下载匹配当前系统版本的Command Line Tools安装包手动安装。
• 第三步：验证Command Line Tools配置
  终端执行命令：

  xcode-select -p
  

  确认输出路径为/Library/Developer/CommandLineTools，若路径不匹配，执行以下命令切换：

  sudo xcode-select -s /Library/Developer/CommandLineTools
  

• 第四步：重新安装Jupyter Notebook
  终端执行命令：

  pip install jupyter
  

备选解决方案 #

若上述步骤执行后仍然报错，可选择以下方案绕过编译步骤：

• 优先安装预编译的argon2-cffi二进制包，再安装Jupyter：

  pip install --only-binary :all: argon2-cffi
  pip install jupyter
  

• 若使用conda环境，直接通过conda安装Jupyter，会自动匹配对应架构的依赖二进制包，无需本地编译：

  conda install jupyter
  

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