Ubuntu 20.04安装pygdal出现use_2to3相关错误的解决方案

问题描述 #

在Ubuntu 20.04环境下执行python3 -m pip install --no-cache-dir pygdal==3.0.4.*安装pygdal时，出现以下报错：

• 提示未知分发选项 use_2to3_fixers、use_2to3_exclude_fixers
• 最终返回错误 error in pygdal setup command: use_2to3 is invalid，安装终止

复现步骤 #

在运行中的Ubuntu 20.04 docker实例内执行如下命令可复现问题：

apt update
# 安装python3.8并将python3链接至该版本，以下2步可根据自身场景调整
apt install -y python3.8
ln -s /usr/bin/python3.8 /usr/bin/python3
# python3.8安装完成
apt install -y python3-pip
apt-get install -y python3-gdal gdal-bin libgdal-dev gcc g++ python3.8-dev git
python3 -m pip install --upgrade --no-cache-dir setuptools==58.0.4
python3 -m pip install --upgrade --no-cache-dir numpy wheel requests
python3 -m pip install --no-cache-dir pygdal==3.0.4.*

问题原因 #

该错误由setuptools版本过高导致：setuptools从58.0.3版本开始移除了对use_2to3相关配置的支持，而pygdal 3.0.4版本的安装脚本仍在使用该配置项，因此安装校验失败。

解决方案 #

将setuptools降级到58.0.2及更早版本即可正常安装，替换原有setuptools安装命令为：

python3 -m pip install --upgrade --no-cache-dir setuptools==58.0.2

之后重新执行pygdal安装命令即可完成安装。

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