Jupyter Notebook无法加载导入OSMnx模块的安装配置问题求解

• 在Jupyter Notebook代码单元格直接执行pip install osmnx时未添加shell命令标识!，Notebook会将该行内容识别为Python语法进行解析，直接触发语法错误。
• 前期通过conda新建的ox环境与现有Notebook绑定的Python环境完全隔离，因此ox环境中安装的osmnx无法被原有Notebook调用；新建环境时未指定匹配的Python版本，conda-forge源拉取的依赖版本与现有运行环境不兼容，就会导致JupyterLab卡顿、无法保存文件的问题。

• 第一步：确认当前Notebook绑定的Python解释器路径，在代码单元格执行以下命令，记录输出的解释器路径：

  import sys
  print(sys.executable)
  

• 第二步：直接在当前Notebook单元格内执行安装命令，优先使用conda安装可自动处理geopandas、shapely等地理依赖的二进制兼容问题，避免pip安装出现编译报错：

  import sys
  !conda install --yes --prefix {sys.prefix} -c conda-forge osmnx
  

  如果conda安装速度过慢，可使用pip对应安装，通过当前解释器路径调用pip可以完全避免包装到其他隔离环境的问题：

  import sys
  !{sys.executable} -m pip install osmnx
  

• 第三步：安装完成后，点击顶部菜单栏Kernel-Restart Kernel重启当前Notebook内核，重启后执行导入命令验证安装结果：

  import osmnx as ox
  # 输出版本号即表示安装成功
  print(ox.__version__)
  

如果后续需要使用独立环境运行osmnx，不需要在ox环境内重复安装jupyterlab，新建环境时指定匹配的Python 3.8.8版本即可避免依赖冲突，执行以下命令：

conda create -n ox python=3.8.8 -c conda-forge --strict-channel-priority osmnx ipykernel
conda activate ox
python -m ipykernel install --user --name ox --display-name "Python (ox)"

配置完成后直接从你原有正常可用的JupyterLab启动，新建或打开已有Notebook时将内核切换为Python (ox)即可正常使用，不会出现卡顿、无法保存的问题。

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