如何用Poetry适配系统中GDAL依赖的版本？

针对Linux环境下，Python项目用Poetry管理依赖时，GDAL包版本必须与系统预安装的libgdal-dev版本匹配，但系统版本受限于Ubuntu发行版或集群环境无法随意修改的场景，以下是几个可行的解决思路：

1. 动态生成版本约束文件安装 #

不在pyproject.toml中固定GDAL版本，而是通过脚本获取系统当前libgdal-dev的版本，生成约束文件后再执行Poetry安装：

• 编写一个简单的shell脚本（比如setup-gdal.sh）：

#!/bin/bash
# 获取系统GDAL版本，若集群有多个版本，可指定gdal-config路径
GDAL_VERSION=$(gdal-config --version)
# 生成约束文件
echo "gdal==$GDAL_VERSION" > gdal-constraints.txt

• 执行脚本后，用约束文件安装依赖：

chmod +x setup-gdal.sh
./setup-gdal.sh
poetry install --constraint gdal-constraints.txt

这样PyPI会安装与系统libgdal-dev完全匹配的GDAL包，同时pyproject.toml中只需保留基础依赖声明：

[tool.poetry.dependencies]
python = "^3.8"
gdal = "*"  # 不固定版本，由约束文件控制

2. 直接通过命令行指定版本安装 #

如果不需要持久化版本到pyproject.toml，可以直接在安装时动态指定GDAL版本：

GDAL_VERSION=$(gdal-config --version)
poetry add gdal==$GDAL_VERSION

这种方式会把匹配的版本写入pyproject.toml和poetry.lock，适合单次安装或环境固定的场景。但如果切换到其他环境，需要重新执行该命令更新版本。

3. 集群多版本环境的适配 #

在有多版本libgdal-dev的集群中，只需指定对应版本的gdal-config路径即可：

# 假设集群中GDAL 3.4.1的gdal-config路径为/usr/local/gdal-3.4.1/bin/gdal-config
GDAL_VERSION=$(/usr/local/gdal-3.4.1/bin/gdal-config --version)
poetry add gdal==$GDAL_VERSION

同时要确保安装时Python能找到对应版本的GDAL库文件，可通过设置环境变量：

export LD_LIBRARY_PATH=/usr/local/gdal-3.4.1/lib:$LD_LIBRARY_PATH

注意事项 #

• 确保系统已安装gdal-config工具（通常随libgdal-dev一起安装），否则无法获取版本信息。
• 部分旧版本GDAL可能没有对应的PyPI包，此时需要从源码构建，可通过指定--no-binary gdal参数：

poetry add gdal==$GDAL_VERSION --no-binary gdal

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