文章目录
- 【避坑指南】Ubuntu 24 快速安装 arm-none-eabi-gdb 及 QEMU 调试实战
-
- 📖 背景说明
- 🛑 避坑：常见的失败尝试
-
- 1. 直接使用 apt-get 安装
- 2. 添加 PPA 软件源
- 3. 从 ARM 官网直接下载
- ✅ 实战：四步极速安装
-
- 步骤 1：清理旧版本
- 步骤 2：高速下载
- 步骤 3：解压安装
- 步骤 4：配置环境变量
- 🛠️ 疑难杂症：缺少依赖库
- 💻 进阶：GDB + QEMU 调试演示
-
- 1. 启动 QEMU 模拟器（终端窗口 A）
- 2. 连接 GDB 开始调试（终端窗口 B）
- 📚 参考资源
【避坑指南】Ubuntu 24 快速安装 arm-none-eabi-gdb 及 QEMU 调试实战
本文旨在记录在 Ubuntu 24 环境下安装 arm-none-eabi-gdb 的最佳实践，涵盖了从“避坑”到“安装”再到“调试”的全流程，助你快速搭建嵌入式开发环境。
📖 背景说明
对于嵌入式开发（如 STM32、GD32 等 Cortex-M 系列单片机），arm-none-eabi-gdb 是必不可少的调试工具。但在 Ubuntu 24.04 等较新的 Linux 发行版中，由于软件包策略的调整，直接通过 apt 安装往往无法获得完整的 GDB 功能，或者版本过旧不支持最新的芯片。本文将介绍一种稳定、高速且独立于系统环境的安装方案。
🛑 避坑：常见的失败尝试
在开始之前，请不要尝试以下方法，以免浪费时间：
1. 直接使用 apt-get 安装
Ubuntu 官方仓库通常只包含 GCC，而不包含 GDB 调试器。
sudo apt-get install gcc-arm-none-eabi # ❌ 仅安装了编译器，无法安装 gdb
2. 添加 PPA 软件源
老旧的 PPA 仓库（如 team-gcc-arm-embedded）已停止维护，在 Ubuntu 24 上会导致 404 错误。
sudo add-apt-repository ppa:team-gcc-arm-embedded/ppa
sudo apt-get update
# ❌ 报错：The repository '…' does not have a Release file.
3. 从 ARM 官网直接下载
虽然可行，但国内网络环境下载速度极慢，且需跨越网络障碍，不推荐作为首选。https://developer.arm.com/downloads/-/gnu-rm
✅ 实战：四步极速安装
推荐使用华为镜像站下载，速度快且版本稳定。
步骤 1：清理旧版本
如果之前尝试安装过，建议先清理环境：
sudo apt-get remove gcc-arm-none-eabi
步骤 2：高速下载
使用华为鸿蒙镜像源下载 10.3 版本（包含 GDB）：
wget https://repo.huaweicloud.com/openharmony/compiler/gcc-arm-none-eabi/10.3/linux/gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2
步骤 3：解压安装
建议将工具链解压至 /opt 目录进行统一管理：
sudo mkdir -p /opt/tool
sudo tar -jxf gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2 -C /opt/tool/
步骤 4：配置环境变量
编辑 ~/.bashrc，将工具链路径加入系统 PATH：
# 在文件末尾添加以下内容
export PATH=$PATH:/opt/tool/gcc-arm-none-eabi-10.3-2021.10/bin
刷新配置使立即生效：
source ~/.bashrc
🔎 验证安装 输入以下命令，如果显示版本号则说明安装成功：
arm-none-eabi-gdb –version
🛠️ 疑难杂症：缺少依赖库
在 Ubuntu 24 上运行 GDB 时，极大概率会遇到以下报错：
arm-none-eabi-gdb: error while loading shared libraries: libncurses.so.5: cannot open shared object file
解决方案： 这是因为新版系统默认不再预装旧版 ncurses 库。需手动安装：
sudo apt install libncurses5 -y
sudo apt autoremove # 清理之前可能安装的冗余依赖
💻 进阶：GDB + QEMU 调试演示
安装完成后，以下是如何配合 QEMU 进行 ARM 裸机调试的示例。
1. 启动 QEMU 模拟器（终端窗口 A）
qemu-system-arm \\
-machine lm3s811evb \\
-kernel firmware.elf \\
-S \\ # 核心参数：启动后立即暂停 CPU，等待 GDB 指令
-gdb tcp::9000 # 核心参数：开启 GDB Server，监听 9000 端口
2. 连接 GDB 开始调试（终端窗口 B）
arm-none-eabi-gdb firmware.elf
进入 GDB 交互界面后输入：
(gdb) target remote localhost:9000 # 连接到 QEMU 端口
(gdb) b main # 在 main 函数打断点
(gdb) c # 恢复运行(Continue)
📚 参考资源
- ARM 官方工具链下载页
- QEMU Cortex-M 模拟器使用指南
- Linux GDB 常用命令速查
本账号所有文章均为原创，欢迎转载，请注明文章出处：https://shandianchengzi.blog.csdn.net/article/details/155863493。百度和各类采集站皆不可信，搜索请谨慎鉴别。技术类文章一般都有时效性，本人习惯不定期对自己的博文进行修正和更新，因此请访问出处以查看本文的最新版本。
