Ubuntu系统Python3.10.6环境下GDAL模块安装及导入问题求助

核心问题分析 #

1. 导入方式错误：GDAL的Python绑定现在统一放在osgeo命名空间下，直接import gdal是旧版本用法，会触发ModuleNotFoundError。
2. APT包名错误：Ubuntu官方源中没有名为gdal的包，正确的系统级GDAL相关包是libgdal-dev（开发依赖）和python3-gdal（系统Python绑定）。
3. 环境版本不匹配：你安装的系统GDAL包（3.4.3）可能对应系统默认Python版本，而非你使用的Python3.10，导致模块无法被当前Python环境识别。

分步解决方案 #

1. 先验证正确的导入方式 #

打开Python3.10终端，执行以下代码：

from osgeo import gdal
print(gdal.__version__)

如果能正常输出版本号，说明模块已存在，只是导入方式不对，问题直接解决。

2. 安装系统级GDAL依赖（如果导入仍失败） #

首先更新APT源：

sudo apt update

安装正确的GDAL包：

sudo apt install libgdal-dev python3-gdal

• libgdal-dev：提供GDAL的核心开发库，是编译Python绑定的前提。
• python3-gdal：系统默认Python环境的GDAL绑定包，若你的Python3.10是系统默认版本，安装后即可直接使用。

3. 针对Python3.10的版本匹配安装 #

如果系统的python3-gdal对应版本不是Python3.10，需要手动安装对应版本的GDAL：

1. 查看系统当前GDAL版本：

gdal-config --version

2. 使用pip3.10安装与系统版本完全一致的GDAL：

pip3.10 install gdal==$(gdal-config --version)

若遇到权限问题，添加--user参数安装到用户目录：

pip3.10 install --user gdal==$(gdal-config --version)

4. 验证安装结果 #

再次打开Python3.10终端，执行：

from osgeo import gdal
print(gdal.__version__)

能正常输出版本号即表示安装成功。

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