Rofi 调试完全指南从崩溃定位、Timings 性能追踪到 GDB 回溯rofi-debugging(5) 实践详解【免费下载链接】rofiRofi: A window switcher, application launcher and dmenu replacement项目地址: https://gitcode.com/gh_mirrors/ro/rofiRofi 是一款 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 -help输出实际被解析的配置文件路径、精确的版本号含 Git 版本、显示器布局monitor layout、后端xcb/wayland信息、可用 modes 列表外部插件 mode 会标注(external)等source/rofi.c 中的print_main_application_options()等帮助打印函数rofi -dump-config以 rasi 格式导出rofi 对当前配置的最终解释结果被修改过的选项会取消注释source/rofi.crofi -dump-theme以 rasi 格式导出rofi 解析后的当前主题含版本头注释用于核对主题语法与属性计算是否正确source/theme.c、source/rofi.c这三个输出的价值在于它们展示的不是你写了什么而是rofi 实际读到了什么。很多配置问题的根源拼写错误、属性名不识别、被更高优先级配置覆盖一眼就能从 dump 结果中看出。日常排查时也可以把rofi -dump-config config.rasi的输出作为你自定义配置的模板起点。用 Timings 调试域分析启动性能当 rofi启动缓慢时官方调试手段是启用Timings调试域G_MESSAGES_DEBUGTimings rofi -show drunGLib 的调试框架会把带时间戳的日志打到 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.crofi_timings_init()创建GTimer并输出Startedrofi_timings_tick()打印当前累计耗时与间隔now - global_timer_last对应宏在 include/timings.h 中定义源码中通过TIMINGS_START()见 source/rofi.c等宏埋点。它本身就以#define G_LOG_DOMAIN Timings声明了调试域所以只要设置G_MESSAGES_DEBUGTimings即可开启不需要重新编译。通过上面的示例可以直观看到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的声明一一对应调试域覆盖范围源码位置all所有调试域—X11HelperX11 辅助函数打开 Display、Setup XCB 等source/xcb/display.cView主窗口视图函数建窗、过滤、更新source/view.c、source/xcb/view.c、source/wayland/view.cWidgets.BoxBox 部件source/widgets/box.cWidgets.ContainerContainer 部件source/widgets/container.cWidgets.IconIcon 部件source/widgets/icon.cModes.DMenudmenu 模式source/modes/dmenu.cModes.Runrun 模式source/modes/run.cModes.DRundesktop 文件运行模式source/modes/drun.cModes.Window窗口模式source/modes/window.cModes.Scriptscript 模式source/modes/script.cModes.Combicombi 组合模式source/modes/combi.cModes.Sshssh 模式source/modes/ssh.cRofi主应用逻辑source/rofi.cTimings性能计时输出source/timings.cTheme主题引擎调试输出警告输出量极大source/theme.cHelpers.IconFetcher图标查找信息source/rofi-icon-fetcher.c完整清单以man rofi即 doc/rofi.1.markdown为准。用法示例——只看 dmenu 模式的调试输出G_MESSAGES_DEBUGModes.DMenu rofi -show drun文档中的示例是G_MESSAGES_DEBUGDialogs.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。文档特别强调指定日志文件会自动启用所有日志域因此这是从窗口管理器环境获取完整诊断信息的最简方式。生成崩溃回溯Backtrace1. 用调试符号重新编译要让回溯包含函数名与行号需要带调试信息编译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 roficoredumpctl会自动找到最近一次 rofi 崩溃产生的 core 并拉起 GDB省去手动定位 core 文件路径的麻烦。完整排障流程小结把文档中的步骤串起来就得到一套可复用的排查流程隔离rofi -no-config必要时再加-no-plugins确认问题是否来自配置/插件收集运行rofi -help、rofi -dump-config、rofi -dump-theme脱敏后附在 issue 中追踪启动慢用G_MESSAGES_DEBUGTimings rofi -show drun定位瓶颈阶段运行期异常用对应模块的调试域如Modes.DRun放大细节从 WM 拉起时用-log ~/rofi.log落盘回溯ulimit -c unlimited复现崩溃 →gdb rofi core→thread apply all bt或直接coredumpctl gdb rofi上报将步骤 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)主题选择器。AUTHORQball Cow qballblame.services【免费下载链接】rofiRofi: A window switcher, application launcher and dmenu replacement项目地址: https://gitcode.com/gh_mirrors/ro/rofi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考