PX4-Autopilot编译环境配置

原创于 2025-11-03 09:20:23 发布 · 349 阅读

9 ·

CC 4.0 BY-SA版权

文章标签：

#PX4

PX4研究专栏收录该内容

1 篇文章

订阅专栏

PX4版本号：1.16

Ubuntu ：Jammy Desktop

【问题】

在参考官方文档配置PX4的环境时，运行以下脚本报错

sh Tools/setup/ubuntu.sh

下列软件包有未满足的依赖关系：
 python3-dev : 依赖: python3 (= 3.10.6-1~22.04) 但是 3.10.6-1~22.04.1 正要被安装
E: 无法修正错误，因为您要求某些软件包保持现状，就是它们破坏了软件包间的依赖关系。

根据提示，Jammy安装时python版本是3.10.6-1~22.04.1，而python3-dev依赖的版本是3.10.6-1~22.04，导致无法配置环境。

参考通义给出的方案一一进行了验证：

✅ 已验证的成功解决方案（来自 Ubuntu + PX4 社区）

🔧 步骤 1：强制刷新软件源（关键！）

有时 apt update 并未真正拉取到最新元数据，尤其是当系统长时间未更新时。

sudo apt clean
sudo apt update --fix-missing

💡 --fix-missing 会强制重新下载索引，解决“版本不同步”问题。

🔧 步骤 2：检查当前可用的 `python3` 和 `python3-dev` 版本

apt policy python3 python3-dev

理想输出应类似：

python3:
  Installed: 3.10.6-1~22.04.1
  Candidate: 3.10.6-1~22.04.1
  Version table:
 *** 3.10.6-1~22.04.1 500
        500 http://archive.ubuntu.com/ubuntu jammy-updates/main amd64 Packages
        100 /var/lib/dpkg/status

python3-dev:
  Installed: (none)
  Candidate: 3.10.6-1~22.04.1   ← 必须和上面一致！
  Version table:
     3.10.6-1~22.04.1 500
        500 http://archive.ubuntu.com/ubuntu jammy-updates/main amd64 Packages

✅ 如果 python3-dev 的 Candidate 版本也是 3.10.6-1~22.04.1，说明源已同步，直接安装：

sudo apt install python3-dev=3.10.6-1~22.04.1

🔧 步骤 3：如果 `python3-dev` Candidate 仍是 `3.10.6-1~22.04`（无 `.1`）

说明你的软件源尚未包含带 .1 的 python3-dev。此时有两种选择：

✅ 方案 A：降级 `python3` 到 `3.10.6-1~22.04`（安全！）

这是 最稳妥且被广泛采用的方法，因为 3.10.6-1~22.04 是 Ubuntu 22.04 初始发布版本，完全兼容。

# 1. 安装指定旧版本 python3
sudo apt install python3=3.10.6-1~22.04

# 2. 锁定版本防止自动升级（可选但推荐）
sudo apt-mark hold python3

# 3. 安装匹配的 python3-dev
sudo apt install python3-dev

✅ 验证：

python3 --version  # 应为 Python 3.10.6
dpkg -l | grep python3-dev  # 应显示 3.10.6-1~22.04

📌 为什么安全？
3.10.6-1~22.04 是官方标准版本，无安全风险。PX4、ROS2 等均在此版本测试通过。

✅ 方案 B：手动下载并安装带 `.1` 的 `python3-dev`（高级）

从 Ubuntu 官方仓库手动下载 .deb 包：

# 1. 访问 Ubuntu 包网站
# https://packages.ubuntu.com/jammy-updates/python3-dev

# 2. 下载对应架构的 .deb（以 amd64 为例）
wget http://archive.ubuntu.com/ubuntu/pool/main/p/python3.10/python3-dev_3.10.6-1~22.04.1_amd64.deb
wget http://archive.ubuntu.com/ubuntu/pool/main/p/python3.10/python3.10-dev_3.10.6-1~22.04.1_amd64.deb

# 3. 安装
sudo dpkg -i python3.10-dev_3.10.6-1~22.04.1_amd64.deb
sudo dpkg -i python3-dev_3.10.6-1~22.04.1_amd64.deb

# 4. 修复依赖
sudo apt --fix-broken install

⚠️ 注意：需同时安装 python3.10-dev，因为 python3-dev 是其依赖包装器。

🚫 绝对不要做的操作

❌ sudo apt remove python3 → 系统崩溃
❌ 手动编译安装 Python 覆盖系统版本 → 破坏包管理

✅ 推荐最终操作（99% 用户适用）

# 1. 降级到标准版本（安全且简单）
sudo apt install python3=3.10.6-1~22.04 python3-minimal=3.10.6-1~22.04

# 2. 安装 dev 包
sudo apt install python3-dev

# 3. （可选）锁定版本
sudo apt-mark hold python3 python3-minimal python3-dev

最终验证，此方法最有效。