MacBook Pro(M1 Max)安装kwant后仍遇ModuleNotFoundError求助

设备信息 #

• 型号：MacBook Pro（型号标识符：MacBookPro18,2）
• 芯片：Apple M1 Max
• 核心配置：10核（8个性能核心+2个能效核心）
• 内存：64GB

已尝试的安装操作 #

先后执行过以下两条安装命令：

pip install kwant

conda install -c conda-forge kwant

报错内容 #

运行代码时触发ModuleNotFoundError，具体回溯信息如下：

ModuleNotFoundError                       Traceback (most recent call last)
/Users/m0/Documents/main_mo/repos/topocm_content/code/init_course.ipynb Cell 1 in <cell line: 11>()
      9 # 2. External package imports
     10 import holoviews
---> 11 import kwant
     12 import matplotlib
     13 import numpy as np

ModuleNotFoundError: No module named 'kwant'

解决方案 #

1. 确认Python环境一致性 #

• 在Jupyter Notebook中运行以下代码，查看当前使用的Python路径：

  import sys; print(sys.executable)
  

• 在终端执行which pip或which conda，对比输出路径与Notebook的Python路径是否一致。若不一致，切换到对应环境重新安装Kwant，或配置Notebook使用已安装Kwant的环境。

2. 针对Apple Silicon的适配安装 #

M1芯片为ARM架构，可通过创建专属conda环境解决兼容性问题：

# 创建并激活环境
conda create -n kwant_env python=3.9
conda activate kwant_env
# 在环境内安装Kwant
conda install -c conda-forge kwant
# 从该环境启动Notebook
jupyter notebook

之后在Notebook中尝试导入Kwant。

3. 手动添加安装路径（pip安装场景） #

• 在终端执行pip show kwant，复制输出中的Location路径。
• 在Notebook中手动将该路径添加到Python的搜索路径：

  import sys
  sys.path.append("复制的Location路径")
  import kwant
  

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