Debian 13 安装 btop++ 完整指南

btop++ 是一款现代化的终端系统资源监控工具，支持 CPU、内存、磁盘、网络和进程的实时监控，拥有美观的 TUI 界面和丰富的交互功能。

---

一键安装命令

以下命令将自动完成所有安装步骤，直接复制执行即可：

apt update && apt install -y build-essential git && cd /tmp && git clone https://github.com/aristocratos/btop.git && cd btop && make && make install
复制

---

为什么要源码编译？

• GitHub Release 提供了多种架构的预编译二进制文件（aarch64、armv7、riscv64 等），但没有提供 x86_64 架构的预编译包
• 预编译包使用 musl 静态链接，不支持 GPU 监控
• 源码编译可获得最新版本的全部功能，并启用 GPU 监控支持

---

环境要求

btop++ v1.4.6 起要求 C++23 标准，编译器需满足以下最低版本：

• GCC 14 或更高
• Clang 19 或更高

Debian 13 (Trixie) 默认自带 GCC 14，无需额外配置编译器。

---

分步安装

1. 安装编译依赖

apt update && apt install -y build-essential git
复制

2. 拉取源码

cd /tmp
git clone https://github.com/aristocratos/btop.git
复制

3. 编译

cd btop
make
复制

如不需要 GPU 监控，可禁用：

make GPU_SUPPORT=false
复制

4. 安装

make install
复制

默认安装到 /usr/local。如需指定其他路径：

make install PREFIX=/opt/btop
复制

5. 运行

btop
复制

---

可选：启用 CPU 功耗和 Intel GPU 监控

# 推荐方式：设置 capabilities
sudo make setcap

# 或者：设置 setuid
sudo make setuid
复制

---

卸载

sudo make uninstall
复制

---

常见问题

Q: 编译报错提示 C++23 不支持？

确认 GCC 版本是否为 14 或更高：

gcc --version
复制

如果在 Debian 12 或更早版本上编译，需要手动安装 GCC 14。

Q: 图形字符显示异常？

确保终端支持 24-bit Truecolor 和 UTF-8 编码，并且使用的字体包含 Braille Patterns (U+2800-U+28FF) 字符。推荐使用 Nerd Fonts 系列字体。

Q: NVIDIA GPU 监控不工作？

需要安装 NVIDIA 官方驱动及 nvidia-ml 动态库，预编译的静态二进制包不支持 GPU 监控。

Q: AMD GPU 监控不工作？

需要安装 rocm_smi_lib。如果发行版未提供该包，可以在编译时使用静态链接：

git clone https://github.com/rocm/rocm_smi_lib.git --depth 1 -b rocm-5.6.x lib/rocm_smi_lib
make RSMI_STATIC=true
复制

---

参考链接

• GitHub 仓库：https://github.com/aristocratos/btop
• 最新 Release：https://github.com/aristocratos/btop/releases/latest
• 主题目录：https://github.com/aristocratos/btop/tree/main/themes