### 解决方案 在 Linux 系统下遇到 `ModuleNotFoundError: No module named 'gdal'` 或者 `ModuleNotFoundError: No module named 'osgeo'` 的错误，通常是因为 GDAL 库未正确安装或环境配置有问题。以下是详细的解决方案： #### 1. 安装 GDAL 和其依赖项 确保系统上已经安装了 GDAL 及其 Python 绑定库。可以使用以下命令来完成安装。 对于基于 Debian/Ubuntu 的系统： ```bash sudo apt-get update sudo apt-get install gdal-bin python3-gdal libgdal-dev ``` 对于基于 RedHat/CentOS 的系统： ```bash sudo yum install epel-release sudo yum install gdal gdal-python ``` 如果需要特定版本的 GDAL，可以通过源码编译安装[^1]。 #### 2. 使用 Conda 进行安装 Conda 是一种强大的包管理工具，适用于 Anaconda 用户。通过 Conda 安装 GDAL 能够更好地兼容不同版本的 Python。 卸载现有的冲突版本： ```bash conda remove --force gdal ``` 重新安装适合当前 Python 版本的 GDAL： ```bash conda install -c conda-forge gdal ``` 注意：某些高版本的 GDAL 不再支持直接使用 `import gdal`，而是推荐使用 `from osgeo import gdal`[^3]。 #### 3. 配置环境变量 有时即使安装了 GDAL，仍可能因为路径问题无法找到模块。检查并设置以下环境变量： ```bash export PATH=/usr/local/bin:$PATH export LD_LIBRARY_PATH=/usr/local/lib:$LD_LIBRARY_PATH export PYTHONPATH=/usr/local/lib/python3.x/site-packages:$PYTHONPATH ``` 将上述内容加入到 `.bashrc` 文件中以永久生效。 #### 4. 测试安装是否成功 运行简单的测试脚本来验证 GDAL 是否正常工作。 ```python try: from osgeo import gdal print("GDAL version:", gdal.__version__) except ImportError as e: print(f"Error importing GDAL: {e}") ``` #### 5. 常见问题排查 - 如果仍然提示 `ModuleNotFoundError: No module named 'osgeo'`，可能是多个 Python 环境共存导致的问题。建议创建独立的虚拟环境后再安装 GDAL[^5]。 - 对于 Windows 平台上的用户，可以从 [Unofficial Windows Binaries for Python Extension Packages](https://www.lfd.uci.edu/~gohlke/pythonlibs/#gdal) 下载预编译好的二进制文件，并用 pip 安装对应的.whl 文件[^4]。 --- ### 示例代码 下面是一个完整的示例程序用于加载 GeoTIFF 图像数据： ```python from osgeo import gdal def load_geotiff(file_path): dataset = gdal.Open(file_path, gdal.GA_ReadOnly) if not dataset: raise Exception("Failed to open the file.") band = dataset.GetRasterBand(1) data_array = band.ReadAsArray() return data_array if __name__ == "__main__": try: raster_data = load_geotiff('example.tif') print(raster_data.shape) except Exception as e: print(e) ``` ---