虚拟环境成功安装pikepdf后Jupyter无法导入该库问题求助

1. 验证环境匹配性 #

这是该类问题最常见的诱因：Jupyter运行使用的Python内核，和你安装pikepdf的虚拟环境不属于同一个。

• 打开安装pikepdf时使用的Anaconda提示符，激活对应虚拟环境，执行命令pip show pikepdf，记录输出中Location字段的路径。
• 打开报错的Jupyter Notebook，运行以下代码，输出当前Jupyter内核对应的Python路径，和上一步的路径做对比：

import sys
print(sys.executable)

若二者路径不匹配，即可确定是内核不匹配问题，执行下一步操作修复。

2. 注册虚拟环境到Jupyter内核 #

• 回到Anaconda提示符，激活安装了pikepdf的虚拟环境，执行命令安装ipykernel：
  pip install ipykernel
• 执行内核注册命令，可自行替换命令中的pikepdf_env为你方便识别的内核名称：
  python -m ipykernel install --user --name=pikepdf_env
• 重启Jupyter，打开目标Notebook后，在顶部菜单栏依次点击Kernel→Change Kernel，选择你刚注册的pikepdf_env内核，重新导入pikepdf测试即可。

3. 异常场景排查 #

如果上述操作未解决问题，按以下项逐一验证：

• 执行conda list -n 你的虚拟环境名称 pikepdf，确认pikepdf确实安装在目标虚拟环境下，未出现环境选择错误的情况。
• 如果你之前使用pip install --user pikepdf命令安装过该库，先激活虚拟环境执行pip uninstall pikepdf，再重新执行pip install pikepdf，避免用户级安装和虚拟环境包路径冲突。
• 若设备存在多Python版本共存的情况，确认安装时使用的pip和Jupyter内核对应的Python版本一致，避免出现pip对应Python3.8、Jupyter用Python3.9这类版本不匹配问题。

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