在 Python 中安装 GDAL（Geospatial Data Abstraction Library）库较为特殊，因为它有原生 C++ 依赖。以下是推荐的安装方法，适用于不同平台（Windows、macOS、Linux）：

🧰 一、安装前的准备

查看 Python 版本和 pip 状态：

python --version
pip --version

确保你正在使用的是 Python 3.7 ~ 3.11（过高或过低可能导致兼容性问题）。

✅ 二、推荐方法：使用 conda 安装（强烈推荐）

如果你使用的是 Anaconda 或 Miniconda 环境，可以使用以下命令：

conda install -c conda-forge gdal

优势：

  • 自动解决 GDAL 本地依赖（如 libgdal）
  • 会自动安装 numpy、proj、geos、libtiff 等

🐍 三、使用 pip 安装（需先准备依赖）

pip install GDAL

但注意：

此方法对依赖库要求高，需要你事先在系统中安装好 C++ 的 GDAL 库（非 Python），否则会报错。

💡 Windows 用户专用安装方法（如 pip 失败）

  1. 打开 Unofficial Windows Binaries for Python Extension Packages
  2. 下载与你的 Python 版本 & 架构相匹配的 .whl 文件（如：GDAL‑3.6.0‑cp39‑cp39‑win_amd64.whl）
  3. 在下载目录中执行：
pip install GDAL‑3.6.0‑cp39‑cp39‑win_amd64.whl

🧱 Linux/macOS 用户：系统包管理器先装 GDAL

Ubuntu / Debian：

sudo apt update
sudo apt install gdal-bin libgdal-dev
pip install GDAL

macOS（推荐 Homebrew）：

brew install gdal
pip install GDAL

可添加环境变量：

export CPLUS_INCLUDE_PATH=/usr/local/include
export C_INCLUDE_PATH=/usr/local/include

🧪 检查安装是否成功

import osgeo.gdal as gdal
print(gdal.__version__)

若能正常输出版本号，则安装成功。

📌 小贴士

  • 若安装困难，优先尝试 Conda 环境安装；
  • 若必须使用 pip，请确保 C++ 库已正确安装并配置环境变量；
  • fiona、rasterio 等也依赖 GDAL，安装时会自动拉取部分依赖；
  • 使用虚拟环境可以避免污染主环境。

以下是为你量身定制的 GDAL 安装虚拟环境配置文件（适用于 Conda 环境），以及完整安装脚本和环境检测工具。

✅ 一、推荐方案：使用 Conda 创建并配置 GDAL 环境

1️⃣ 创建名为 geo_env 的新环境

保存以下内容为 gdal_env.yml 文件：

name: geo_env
channels:
  - conda-forge
dependencies:
  - python=3.10
  - gdal
  - numpy
  - matplotlib
  - geopandas
  - rasterio
  - fiona
  - pyproj
  - jupyter
  - notebook

安装命令：

conda env create -f gdal_env.yml
conda activate geo_env

💡 此环境支持完整的地理信息处理工作流（GDAL + GeoPandas + RasterIO + PyProj）

🧰 二、安装检测脚本

以下是 Python 脚本 check_gdal_install.py，可验证安装状态：

try:
    import osgeo.gdal as gdal
    import osgeo.ogr as ogr
    import osgeo.osr as osr

    print("✅ GDAL 版本:", gdal.__version__)
    print("✅ 支持的驱动数:", gdal.GetDriverCount())

    print("✅ OGR 支持:", ogr.GetDriverCount(), "个驱动")
    print("✅ OSR 支持:", osr.SpatialReference().ExportToWkt())

except ImportError as e:
    print("❌ GDAL 未正确安装：", e)

运行命令：

python check_gdal_install.py

🛠️ 三、可选 Pip 安装脚本（仅限 Linux/macOS 熟手使用）

# 系统安装 GDAL C++ 库
sudo apt update
sudo apt install gdal-bin libgdal-dev python3-dev

# 设置环境变量（示例路径，按需修改）
export CPLUS_INCLUDE_PATH=/usr/include/gdal
export C_INCLUDE_PATH=/usr/include/gdal

# 安装 Python 绑定
pip install GDAL

📦 附加工具推荐（可选）

工具用途
QGIS桌面 GIS 工具，GDAL 内置
ogr2ogrGDAL 命令行转换工具
gdalinfo查看栅格/矢量数据元信息
GeoPandasPython 中的矢量地理数据处理库

✅ 总结建议

  • 使用 Conda + conda-forge 通道是最稳定的方式；
  • 若用 pip，需配置系统库；
  • 可将环境导出备份：conda env export > backup.yml

是否需要我生成这个环境的 .yml 文件或打包为可执行安装脚本（支持 Windows/Linux/macOS）？如果你想在 Jupyter Notebook 里写 GIS 脚本，我也可以提供模板。欢迎继续告诉我需求。