JupyterLab/Jupyter Notebook报GDAL未安装错误 同环境命令行运行正常

1. 验证Jupyter实际调用的Python解释器路径 #

这是该场景下占比最高的故障原因：即使你在命令行激活了对应conda环境再启动Jupyter，也可能因为内核配置错位，导致Jupyter实际调用的解释器，和命令行里能正常跑GDAL的解释器不是同一个。
具体操作流程：

• 在Jupyter的独立单元格中依次执行以下代码，记录输出结果：
  • import sys
  • print(sys.executable)
• 在已激活目标conda环境的命令提示符中执行where python，对比两端输出的解释器绝对路径：
  • 如果两个路径存在差异，说明Jupyter根本没有加载你安装GDAL的那个Python环境
• 错位问题的修复操作：
  1. 回到目标conda环境的命令提示符，执行内核注册命令：python -m ipykernel install --user --name=你的环境名 --display-name="Python (对应环境名)"
  2. 重启Jupyter Notebook，在顶部菜单栏的「内核」-「更改内核」选项中，选择刚刚注册的对应环境内核，再重新测试导入GDAL即可。

2. 排查Windows权限拦截导致的路径读取失败 #

如果你的conda环境安装在受系统UAC管控的路径（比如C:\ProgramData\Anaconda3这类全局系统目录），会出现典型的权限差故障：命令行用管理员权限激活环境时可以正常加载GDAL，但Jupyter以普通用户权限启动时，没有权限读取系统目录下的site-packages文件，就会抛出模块找不到的错误。
对应修复操作：

• 先做验证：分别在普通权限、管理员权限的命令提示符中激活同一个conda环境，测试import gdal的运行结果
• 如果权限差异导致导入结果不同，二选一解决：
  • 将conda环境迁移到当前用户拥有完整读写权限的目录下（例如C:\Users\你的用户名\anaconda3\envs\路径）
  • 启动Jupyter时直接以管理员权限运行，绕过UAC的路径读取拦截。

3. 修正Jupyter的错误启动方式 #

如果你的Jupyter是通过桌面快捷方式、开始菜单图标直接启动，没有先在当前终端激活目标conda环境，会出现Python路径优先级错位的问题：Jupyter会优先加载全局默认Python路径下的模块，跳过当前激活环境的site-packages目录，哪怕GDAL已经装在对应环境里也识别不到。
对应修复操作：

• 验证方式：在Jupyter单元格中运行sys.path，检查输出的路径列表中，是否存在你安装GDAL的conda环境对应的Lib\site-packages目录，如果没有就属于这类问题
• 修正操作：
  • 所有Jupyter服务必须在激活了目标conda环境的终端窗口中，执行jupyter notebook命令启动，不能直接从全局快捷方式唤起服务
  • 不要在Jupyter的单元格中通过!pip install gdal/!conda install gdal这类内联命令安装依赖，这类操作安装的模块路径不一定会被当前内核识别，所有依赖安装都要在对应环境的命令行中完成。

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