Ubuntu20.04 LTS Python3.8虚拟环境无法安装GDAL3.4及以上版本

问题梳理 #

• 环境：Ubuntu 20.04 LTS、Python 3.8、PyCharm虚拟环境
• 现状：默认apt源安装的GDAL版本为3.0.4，无法满足3.4+需求；执行pip install gdal==3.0.4触发错误：error in GDAL setup command: use_2to3 is invalid
• 已安装的apt包版本：

  WARNING: apt does not have a stable CLI interface. Use with caution in scripts.
  
  gdal-bin/focal,now 3.0.4+dfsg-1build3 amd64 [installed]
  gdal-data/focal,focal,now 3.0.4+dfsg-1build3 all [installed,automatic]
  libgdal-dev/focal,now 3.0.4+dfsg-1build3 amd64 [installed]
  libgdal26/focal,now 3.0.4+dfsg-1build3 amd64 [installed,automatic]
  python3-gdal/focal,now 3.0.4+dfsg-1build3 amd64 [installed]
  

解决步骤 #

1. 添加UBUNTUGIS PPA源获取高版本GDAL #

Ubuntu 20.04默认源的GDAL版本停留在3.0.4，需添加UBUNTUGIS的PPA获取更新版本：

sudo add-apt-repository ppa:ubuntugis/ppa
sudo apt update

2. 卸载旧版本GDAL包避免冲突 #

彻底移除已安装的旧版本GDAL相关组件：

sudo apt remove --purge gdal-bin gdal-data libgdal-dev libgdal26 python3-gdal
sudo apt autoremove && sudo apt autoclean

3. 安装指定版本的GDAL系统库 #

先查看PPA中可用的GDAL 3.4+版本：

apt-cache policy gdal-bin

从输出中找到3.4及以上的版本号（例如3.4.1+dfsg-1~focal0），安装对应版本的核心库（确保gdal-bin和libgdal-dev版本完全一致）：

sudo apt install gdal-bin=3.4.1+dfsg-1~focal0 libgdal-dev=3.4.1+dfsg-1~focal0 gdal-data

4. 在虚拟环境中安装匹配版本的Python GDAL包 #

先确认系统安装的GDAL版本：

gdal-config --version

激活虚拟环境后，安装与系统库版本完全匹配的GDAL包：

pip install GDAL==$(gdal-config --version)

关于use_2to3 is invalid错误的说明 #

该错误是因为GDAL 3.0.4的安装脚本依赖Python 3.8+版本setuptools已移除的use_2to3选项，无需尝试安装该旧版本，通过上述步骤安装3.4+版本即可解决。

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