企业官网建设流程全解析

Rofi 调试完全指南：从崩溃定位、Timings 性能追踪到 GDB 回溯（rofi-debugging(5) 实践详解）

【免费下载链接】rofiRofi: A window switcher, application launcher and dmenu replacement项目地址: https://gitcode.com/gh_mirrors/ro/rofi

Rofi 是一款 X11 下的窗口切换器、应用启动器与 dmenu 替代工具。当它崩溃或行为异常时，往往很难立刻判断问题出在自定义配置、外部插件还是 rofi 自身。本文基于仓库中的 doc/rofi-debugging.5.markdown 手册页，系统讲解 rofi 的调试方法论：先用-no-config隔离配置干扰，再通过-help、-dump-config、-dump-theme收集诊断信息，然后借助 GLib 调试域输出运行期日志、用 Timings 域分析启动性能瓶颈，最后利用 GDB 与 core dump 生成崩溃回溯。读完本文，你将掌握一套从"现象 → 信息收集 → 定位 → 回溯"的完整排障流程，能够独立提交高质量的 bug 报告。

第一步：隔离问题——禁用自定义配置与插件

在向项目提交任何 issue 之前，文档建议先做一个最小化验证：先用默认配置复现问题。

rofi -no-config

-no-config会跳过所有配置文件的解析，让 rofi 以"出厂状态"（stock mode）运行。从源码看，该选项在 source/rofi.c 中被多处检查（例如第 483、1155 行），用于决定是否加载用户配置：

• 系统配置文件（如/etc/rofi.rasi，按XDG_CONFIG_DIRS与编译期SYSCONFDIR顺序查找）
• 用户的 rasi 主题配置文件
• 命令行参数（命令行始终生效，不受-no-config影响，见 source/rofi.c 附近"Parse command line for settings, independent of other -no-config"）

如果在-no-config下问题不再出现，说明问题几乎可以确定出在你的配置或主题文件上；如果问题依旧，则是 rofi 自身或系统环境层面的问题，可以继续往下收集信息。

如果你的环境运行了自定义的C 语言插件（rofi 支持通过动态模块扩展新的 mode，源码见 source/rofi.c 的rofi_collectmodes_dir()，插件会从配置的插件目录中加载以G_MODULE_SUFFIX结尾的.so文件并导出mode符号），可以再加一个开关：

rofi -no-plugins

-no-plugins会禁止加载所有外部插件（对应实现位于 source/rofi.c）。配合-no-config，就能把"配置问题"和"插件问题"这两个最常见变量彻底排除。

收集 issue 所需的诊断信息

一旦确认需要上报问题，文档要求提供以下三个命令的完整输出（注意：输出中可能包含主机名、用户名等可识别信息，提交前请检查并脱敏）：

rofi -help rofi -dump-config rofi -dump-theme

三者各司其职：

这三个输出的价值在于：它们展示的不是"你写了什么"，而是rofi 实际读到了什么。很多配置问题的根源（拼写错误、属性名不识别、被更高优先级配置覆盖）一眼就能从 dump 结果中看出。日常排查时也可以把rofi -dump-config > config.rasi的输出作为你自定义配置的模板起点。

用 Timings 调试域分析启动性能

当 rofi启动缓慢时，官方调试手段是启用Timings调试域：

G_MESSAGES_DEBUG=Timings rofi -show drun

GLib 的调试框架会把带时间戳的日志打到 stderr。文档给出了一段典型的 trace（节选）：

(process:14942): Timings-DEBUG: 13:47:39.335: 0.000000 (0.000000): Started (process:14942): Timings-DEBUG: 13:47:39.335: 0.000126 (0.000126): ../source/rofi.c:main:786 (process:14942): Timings-DEBUG: 13:47:39.346: 0.010650 (0.008821): ../source/rofi.c:main:844 Setup Display (process:14942): Timings-DEBUG: 13:47:39.350: 0.015101 (0.004386): ../source/rofi.c:main:883 Load cmd config (process:14942): Timings-DEBUG: 13:47:39.351: 0.015291 (0.000016): ../source/view.c:rofi_view_workers_initialize:1922 Setup Threadpool, start (process:14942): Timings-DEBUG: 13:47:39.367: 0.032018 (0.016669): ../source/rofi.c:main:1000 Setup late Display (process:14942): Timings-DEBUG: 13:47:39.381: 0.046113 (0.000114): ../source/rofi.c:startup:684 Config sanity check (process:14942): Timings-DEBUG: 13:47:39.384: 0.048229 (0.002116): ../source/dialogs/run.c:get_apps:216 start (process:14942): Timings-DEBUG: 13:47:39.390: 0.054626 (0.006397): ../source/dialogs/run.c:get_apps:336 stop (process:14942): Timings-DEBUG: 13:47:39.418: 0.082884 (0.027620): ../source/dialogs/drun.c:get_apps:659 Get Desktop apps (system dirs) (process:14942): Timings-DEBUG: 13:47:39.419: 0.083638 (0.000661): ../source/dialogs/drun.c:get_apps:664 Sorting done. (process:14942): Timings-DEBUG: 13:47:39.420: 0.084693 (0.000982): ../source/view.c:rofi_view_refilter:1028 Filter start (process:14942): Timings-DEBUG: 13:47:39.421: 0.085992 (0.001299): ../source/view.c:rofi_view_refilter:1132 Filter done

每一行的格式为：

(进程号): Timings-DEBUG: 时钟时间: 累计耗时(距上一条的间隔): 源文件:函数:行号 事件描述

其中第一个数字是启动以来的累计毫秒数，括号内是上一条记录到当前记录的增量，两者结合可以精确定位时间花在了哪个阶段。

Timings 的实现位于 source/timings.c：rofi_timings_init()创建GTimer并输出Started，rofi_timings_tick()打印当前累计耗时与间隔（now - global_timer_last），对应宏在 include/timings.h 中定义，源码中通过TIMINGS_START()（见 source/rofi.c）等宏埋点。它本身就以#define G_LOG_DOMAIN "Timings"声明了调试域，所以只要设置G_MESSAGES_DEBUG=Timings即可开启，不需要重新编译。

通过上面的示例可以直观看到：drun 模式启动时，最重的开销集中在Get Desktop apps (system dirs)（约 27ms）与run.c:get_apps（约 6ms）——即扫描桌面文件上。如果扫描慢，就可以针对性地排查.desktop文件数量、文件系统性能或图标主题解析。

调试域（Debug Domains）全览

rofi 使用GLib 调试框架按模块划分日志域，通过环境变量G_MESSAGES_DEBUG启用，支持逗号分隔多个域，也可用all打开全部。文档在编写时列出的调试域，与仓库源码中#define G_LOG_DOMAIN的声明一一对应：

完整清单以man rofi（即 doc/rofi.1.markdown）为准。用法示例——只看 dmenu 模式的调试输出：

G_MESSAGES_DEBUG=Modes.DMenu rofi -show drun

文档中的示例是G_MESSAGES_DEBUG=Dialogs.DRun，这是旧版域名；当前版本中 dmenu 与 drun 对应的域分别是Modes.DMenu与Modes.DRun（见上表源码声明），排查时注意以rofi -help或本表为准。

把日志重定向到文件

当 rofi 由窗口管理器自动拉起（而非在终端中手动运行）时，stderr 无处可去。此时可以指定日志文件：

rofi -show drun -log ~/rofi.log

从 source/rofi.c 的实现看，-log会以追加模式打开指定文件（O_APPEND | O_CREAT | O_WRONLY，权限S_IRUSR | S_IWUSR），并通过g_log_set_default_handler()将默认日志处理器替换为写文件的rofi_custom_log_function。文档特别强调：指定日志文件会自动启用所有日志域，因此这是从窗口管理器环境获取完整诊断信息的最简方式。

生成崩溃回溯（Backtrace）

1. 用调试符号重新编译

要让回溯包含函数名与行号，需要带调试信息编译：

make CFLAGS="-O0 -g3" clean rofi

• -O0：关闭优化，避免行号与源码错位；
• -g3：生成最高级别调试信息（含宏展开）。

注：当前仓库使用 Meson 构建系统（见 meson_options.txt），若按 Meson 流程，可在meson setup build后通过meson configure调整c_args（例如meson configure build -Dc_args="-O0 -g3"）实现同等效果；文档中给出的make CFLAGS=...为传统 Makefile 流程的等价写法。

2. 为什么不用交互式 GDB？

文档给出了一条非常实用的工程经验：不要在 GDB 里直接跑 rofi 等它崩溃。因为 rofi 一旦运行，会抓取键盘和鼠标（源码中Grab keyboard埋点见 Timings trace 的../source/rofi.c:startup:677），一旦它在 GDB 中卡死或崩溃，你的鼠标键盘都会被锁住，处境十分被动。

3. 推荐流程：core dump + 事后加载

正确的做法是先开 core dump，再让它崩溃，最后离线分析：

ulimit -c unlimited # 在 bash 中开启 core dump 生成 # 复现崩溃…… gdb rofi core # 加载 core 文件

进入 GDB 后，执行：

thread apply all bt

这会打印所有线程的完整回溯（bt= backtrace），多线程崩溃时（rofi 使用了线程池，见 Timings trace 中的Setup Threadpool）每个线程的栈都会被列出，是定位崩溃现场的关键证据。

4. systemd-coredump 用户

使用 systemd 的发行版通常自带systemd-coredump，可以直接用coredumpctl管理并提取回溯：

coredumpctl gdb rofi

coredumpctl会自动找到最近一次 rofi 崩溃产生的 core 并拉起 GDB，省去手动定位 core 文件路径的麻烦。

完整排障流程小结

把文档中的步骤串起来，就得到一套可复用的排查流程：

1. 隔离：rofi -no-config（必要时再加-no-plugins）确认问题是否来自配置/插件；
2. 收集：运行rofi -help、rofi -dump-config、rofi -dump-theme，脱敏后附在 issue 中；
3. 追踪：启动慢用G_MESSAGES_DEBUG=Timings rofi -show drun定位瓶颈阶段；运行期异常用对应模块的调试域（如Modes.DRun）放大细节；从 WM 拉起时用-log ~/rofi.log落盘；
4. 回溯：ulimit -c unlimited复现崩溃 →gdb rofi core→thread apply all bt（或直接coredumpctl gdb rofi）；
5. 上报：将步骤 2~4 的输出与复现步骤一起提交，附带rofi -help中的精确版本号（含 Git 提交信息）与配置 dump，让维护者能直接复现。

关联文档与延伸阅读

本文主题源自 doc/rofi-debugging.5.markdown，与 rofi 排障相关的手册还有：

• rofi(1)：主手册，含全部命令行参数、配置文件优先级与调试域权威列表；
• rofi-theme(5)：主题格式与属性语法，配合-dump-theme排查主题问题；
• rofi-script(5)：脚本模式，排查 script mode 相关调试域（Modes.Script）时参考；
• rofi-keys(5)：快捷键绑定；
• rofi-dmenu(5)：dmenu 模拟模式（对应Modes.DMenu调试域）；
• rofi-theme-selector(1)：主题选择器。

AUTHOR

• Qball Cow <qball@blame.services>

【免费下载链接】rofiRofi: A window switcher, application launcher and dmenu replacement项目地址: https://gitcode.com/gh_mirrors/ro/rofi