本文共 1436 字，大约阅读时间需要 4 分钟。

当尝试使用 pip 安装 gdal 时，可能会由于 gdal 不是纯净的 Python 库，而是由 C 扩展部分组成，导致安装过程中缺少必要的头文件或依赖项。以下是解决 gdal 安装问题的详细方法：

问题原因

pip install gdal 时可能会出现以下错误：

Building wheel for gdal (setup.py) ... errorERROR: Command errored out with exit status 1:command: 'd:\program\anaconda3\python.exe' -u -c 'import sys, setuptools, tokenize; ...'...fatal error C1083: Cannot open include file: 'cpl_port.h': No such file or directory

这一错误表明安装过程中缺少了 gdal 的必要头文件（如 cpl_port.h），可能导致构建失败。

解决方法

1. 手动下载对应版本的 GDAL 库文件

由于 gdal 不适合通过 pip 直接安装（主要原因是其 C 扩展部分的依赖），可以手动下载对应版本的预编译 GDAL 库文件。

2. 选择合适的版本

根据你的操作系统和 Python 版本选择适合的 GDAL 版本。以下是一些常见的版本：

• GDAL-2.2.4-cp36-cp36m-win_amd64.whl（适用于 64 位 Windows 系统，Python 3.6）
• GDAL-2.2.4-cp37-cp37m-win_amd64.whl（适用于 64 位 Windows 系统，Python 3.7）
• GDAL-2.2.4-cp27-cp27m-win_amd64.whl（适用于 64 位 Windows 系统，Python 2.7）

3. 通过网盘下载

以下是以上提到的 GDAL 文件的下载链接和密码（注意：部分链接可能已过时，建议通过 gdal.org 官方网站查询最新版本）：

• GDAL-2.2.4-cp36-cp36m-win_amd64.whl

  链接：（所需密码：468c）

• GDAL-2.2.4-cp37-cp37m-win_amd64.whl

  链接：（所需密码：9hrj）

• GDAL-2.2.4-cp27-cp27m-win_amd64.whl

  链接：（所需密码：-hash complaints）

4. 使用 pip 安装

下载完成后，可以通过以下命令将 GDAL 库文件安装到 Python 环境中：

pip install "GDAL-2.2.4-cp36-cp36m-win_amd64.whl"

根据你的版本替换文件名后进行安装。

5. 确认安装成功

安装完成后，打开 Python 协议，确认 GDAL 的版本和相关模块是否成功加载：

import osgeoprint(osgeo.__version__)

如果没有错误，可以跳过下一步。

其他注意事项

这种方法可以避免通过 pip 处理 GDAL 的 C 扩展部分，从而解决安装时的依赖问题，确保 GDAL 正确运行。