QGIS3安装笔记

最新推荐文章于 2026-05-22 09:35:39 发布

原创最新推荐文章于 2026-05-22 09:35:39 发布 · 404 阅读

7 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

收录于

carla

环境：

Ubuntu 22.04 LTS（发行版代号jammy）
Python 3.10（满足 QGIS 要求的 3.6 + 版本）
CARLA 0.9.16（满足 >=0.9.10 的版本要求）
CARLA Scenario Runner 已安装
待安装目标：QGIS3、CARLA AD Map plugin >=2.4.5

不要再虚拟环境下载安装

1：更新系统并安装前置依赖工具

先更新 apt 索引，安装添加第三方源所需的基础工具，执行以下命令：

# 更新系统现有软件包索引
sudo apt update && sudo apt upgrade -y

# 安装QGIS安装所需的核心工具
sudo apt install gnupg software-properties-common vim wget -y

2：添加 QGIS 官方签名密钥

用于信任 QGIS 官方软件源，确保安装包的完整性和安全性，执行以下命令：

# 创建密钥存储目录（Ubuntu22.04的apt版本已原生支持，此命令兼容无副作用）
sudo mkdir -m755 -p /etc/apt/keyrings

# 下载并导入QGIS官方签名密钥
sudo wget -O /etc/apt/keyrings/qgis-archive-keyring.gpg https://download.qgis.org/downloads/qgis-archive-keyring.gpg

3：添加 QGIS 官方软件源

sudo tee /etc/apt/sources.list.d/qgis.sources > /dev/null <<EOF
Types: deb deb-src
URIs: https://qgis.org/ubuntu-ltr
Suites: jammy
Architectures: amd64
Components: main
Signed-By: /etc/apt/keyrings/qgis-archive-keyring.gpg
EOF

4：安装 QGIS 核心包及 Python 支持包

更新源后安装 QGIS 核心组件，以及运行 CARLA 插件必需的 Python 支持包，执行以下命令：

重新安装QGIS完整包（含Python支持，插件运行必需）
sudo apt update
sudo apt install qgis python3-qgis qgis-providers python3-pyqt5 python3-sip -y

5:安装常见问题与解决方案（提前规避 + 报错修复）

问题 1：安装时提示「软件包有未满足的依赖关系」「无法修正错误，依赖冲突」

原因:之前安装过旧版 QGIS 相关包、Python 包版本冲突，或源配置错误（比如用了 20.04 的 focal 源）。

解决方案

# 1. 彻底卸载残留的QGIS相关包
sudo apt remove --purge qgis python3-qgis qgis-providers qgis-plugin-grass -y
sudo apt autoremove --purge -y

# 2. 重新核对源配置文件，确保Suites是jammy（Ubuntu22.04）
cat /etc/apt/sources.list.d/qgis.sources

# 3. 重新更新源并安装
sudo apt update
sudo apt install qgis python3-qgis qgis-providers -y

问题 2：启动 QGIS 时弹窗报错「Couldn't load SIP module. Python support will be disabled.」「Qt 版本不匹配」

原因:你本地 pip 安装的 PyQt5，和 QGIS 要求的 apt 源 PyQt5 版本不兼容，是 Ubuntu 环境 Python 包最常见的冲突问题。

解决方案

# 1. 卸载pip安装的PyQt5（当前用户+全局都卸载）
pip3 uninstall PyQt5 -y
sudo pip3 uninstall PyQt5 -y

# 2. 用apt安装QGIS兼容的PyQt5版本
sudo apt install python3-pyqt5 -y

# 3. 重新安装QGIS Python包，修复依赖
sudo apt install --reinstall python3-qgis -y

6：验证 QGIS 正常启动，无报错:

# 在无conda环境的终端直接启动
qgis

✅ 达标标准：启动后无红色的Couldn't load SIP module报错，顶部菜单栏「插件」→「Python 控制台」可正常打开，无异常提示。

7:安装 CARLA AD Map 插件（>=2.4.5）

第一步：彻底退出 conda 环境，锁定系统 Python

这是所有操作的前提，必须严格执行：

# 1. 逐级退出conda，直到命令行前无任何 (base) 或 (carla_py310) 标识
conda deactivate
conda deactivate

# 2. 关闭conda自动激活，避免新开终端仍加载conda
conda config --set auto_activate_base false

# 3. 关闭当前终端，**重新打开一个全新的终端**，确保无conda环境

# 4. 验证当前使用的是系统原生Python和pip
which python3
# 正确输出：/usr/bin/python3
which pip3
# 正确输出：/usr/bin/pip3

第二步：安装最新兼容版依赖（3.0.0 版本，向下兼容 CARLA 0.9.16）

既然 PyPI 只有 3.0.0 版本，我们直接使用该版本，它完全兼容 CARLA 0.9.16 和 QGIS 插件：

# 1. 安装系统基础依赖
sudo apt update
sudo apt install python3-pip python3-numpy python3-lxml python3-pyqt5 python3-sip python3-shapely python3-networkx -y

# 2. 用系统pip3安装最新版ad-map-access（3.0.0）
sudo /usr/bin/pip3 install ad-map-access==3.0.0

第三步：直接安装 QGIS 插件（无需再装其他依赖）

打开插件官方最新发布页：https://github.com/carla-simulator/map/releases
在页面的Assets区域，下载最新的标准插件包：carla_ad_map_access-3.0.0.zip（不要下载 Source code 源码包）。
确保你在无 conda 环境的终端（命令行前无(base)或(carla_py310)），直接输入qgis启动 QGIS。
进入 QGIS 插件管理器，点击【Install from ZIP】，选择刚下载的carla_ad_map_access-3.0.0.zip，点击【Install Plugin】完成安装。
安装完成后，在「Installed」列表中，勾选CARLA AD Map Access启用插件。

离线加载地图

如果在线连接 CARA 有问题，你可以直接加载 CARLA 内置的地图文件：

点击 Database → CARLA ad_map_access → Load OpenDRIVE Map
在文件选择窗口中，进入你的 CARLA 目录：/carla_disk/carla/CarlaUE4/Content/Carla/Maps/OpenDrive/Town02.xodr
选择Town02.xodr文件，点击打开，QGIS 就会加载完整路网。

8：Traffic Generation Editor 插件安装（同步适配）

这个插件全称是 OpenSCENARIO Editor Toolkit，是 CARLA 官方维护的自动驾驶场景编辑插件，唯一官方仓库： https://github.com/carla-simulator/traffic-generation-editor

方法 1：Git 克隆安装

直接通过 git 把仓库克隆到 QGIS 插件目录，一步解决命名不合法的问题，不用改任何文件名、任何代码：打开终端，进入你的 QGIS 插件目录：

cd /home/ljj/.local/share/QGIS/QGIS3/profiles/default/python/plugins

克隆仓库并直接重命名为合法的 Python 包名（无连字符、无版本号）：

git clone  https://github.com/carla-simulator/traffic-generation-editor.git  traffic_editor

安装插件必需的 Python 依赖：

cd traffic_editor

pip3 install --user xmlschema -i http://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com

cd /home/ljj/.local/share/QGIS/QGIS3/profiles/default/python/plugins/traffic_editor

find . -name "*.py" -exec sed -i 's/from osc_generator/from .osc_generator/g' {} \;
find . -name "*.py" -exec sed -i 's/import osc_generator/from . import osc_generator/g' {} \;

重启 QGIS，进入「插件→管理并安装插件」，直接启用 OpenSCENARIO Editor Toolkit 即可。