Jupyter Notebook报“No module named qiskit”错误但pip已安装该包

核心原因是Jupyter Notebook使用的Python内核与安装Qiskit的conda虚拟环境不匹配，导致找不到已安装的模块。

解决方案步骤 #

• 激活你的conda虚拟环境：

  conda activate 你的虚拟环境名称
  

• 在虚拟环境内安装ipykernel（用于将虚拟环境注册为Jupyter内核）：

  pip install ipykernel
  

• 将当前虚拟环境添加为Jupyter可用内核：

  python -m ipykernel install --user --name=你的虚拟环境名称 --display-name="Python (你的虚拟环境名称)"
  

  说明：--display-name是Jupyter界面中显示的内核名称，可自定义，方便区分不同环境。
• 重启Jupyter Notebook，切换内核：
  打开Notebook后，点击顶部菜单栏的「Kernel」→「Change kernel」，选择刚才添加的带有虚拟环境名称的内核，再执行import qiskit即可。

额外排查点 #

• 确认启动Jupyter前已激活目标虚拟环境，若在base环境启动Jupyter，默认会使用base环境的内核。
• 再次执行pip list确认Qiskit确实安装在当前激活的虚拟环境中，避免环境混淆。

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