暗无天日

=============>DarkSun的个人博客

读:Amin Bandali 与 Protesilaos 谈 Emacs 内置功能的深度定制

最近看了 Amin BandaliProtesilaos(下称 Prot)的一场 Emacs 教练会议录像。两人聊了很多话题:窗口管理、搜索、日程管理。看起来互不相关,但底层都指向同一件事:Emacs 的内置功能本身就有很深的定制空间,只是这些接口藏在文档里,很少有人翻到。

下面从会议中提炼三个案例,每个都配上实际可用的代码。

案例一: display-buffer-alist — 掌控窗口布局

Prot 在会议中说: display-buffer-alist 是让 Emacs 有归属感的"唯一最重要的变量"。这个变量控制 Emacs 在什么条件下、把新 buffer 显示在什么位置。

默认行为的问题。 Emacs 默认的窗口管理比较粗暴:按 C-h f 查函数文档,help buffer 直接抢占你当前窗口;运行 M-x compile ,编译输出也抢占当前窗口。如果你同时开着代码和 shell,查个文档回来窗口布局就乱了。

配置示例:让 help buffer 侧边弹出,不抢占当前窗口。

(add-to-list 'display-buffer-alist
             '("\\*Help\\*"
               (display-buffer-reuse-window display-buffer-in-side-window)
               (window-width . 0.4)
               (side . right)
               (slot . 0)
               (window-parameters . ((no-delete-other-windows . t)))))

当 buffer 名匹配 \*Help\* 时,Emacs 会优先复用已有的 help 窗口( display-buffer-reuse-window );如果没有已有窗口,就在右侧弹出宽度为 40% 的 side window( display-buffer-in-side-window + side . right + window-width . 0.4 )。side window 的好处是按 C-x 1 不会被关闭,适合放需要反复查看的辅助窗口。

配置示例:让编译输出显示在底部,不抢占焦点。

(add-to-list 'display-buffer-alist
             '("\\*compilation\\*"
               (display-buffer-reuse-window display-buffer-at-bottom)
               (window-height . 0.25)
               (body-function . (lambda (window) (select-window window nil)))))

display-buffer-at-bottom 把 buffer 放在底部,高度占屏幕 25%。 body-function 让光标跳到编译窗口,方便直接查看输出( display-buffer 默认不切换焦点,所以需要显式指定)。

display-buffer-alist 本质上是一个匹配规则列表:每条规则由 buffer 名的正则表达式和一组 action 函数组成。针对不同类型的 buffer 可以设置不同的显示策略,不需要为每种情况单独写 Elisp 函数。Emacs 内置了十几种 action 函数( display-buffer-same-windowdisplay-buffer-pop-up-frame 等),日常的窗口布局需求基本都能覆盖。

案例二:isearch — 被低估的内置搜索

会议中 Prot 展示了几个 isearch 的定制技巧。isearch 是 Emacs 内置的增量搜索(按 C-s 触发),比起 consult-line 或者 swiper 名气小一些,但配好了完全够用。

空格当通配符。

默认情况下,isearch 里输入空格就是匹配空格。但如果你把空格配置为匹配"任意字符",搜索 hello world 就能匹配 hello, something worldhelloxyzworld 等包含中间内容的行:

(setq search-whitespace-regexp ".*?")
(setq isearch-lax-whitespace t)
(setq isearch-regexp-lax-whitespace nil)

这三行配置的含义:

  • search-whitespace-regexp 设置空格匹配的正则表达式, ".*?" 是非贪婪匹配任意字符
  • isearch-lax-whitespace 设为 t ,让普通搜索(非正则模式)中空格被替换为通配符
  • isearch-regexp-lax-whitespace 设为 nil ,正则模式下不替换空格,保留正则的精确控制

显示匹配计数。

isearch 默认不显示"第几个匹配 /共几个匹配"。开启 isearch-lazy-count 后,minibuffer 里会显示类似"5/12"的计数:

(setq isearch-lazy-count t)
(setq lazy-count-prefix-format "(%s/%s) ")
(setq lazy-count-suffix-format nil)

什么时候用 isearch,什么时候用 consult-line?

Prot 提到 isearch 在录制键盘宏时特别有用,因为搜索过程是增量的、可回退的。consult-line(配合 vertico 和 orderless)的优势在于候选列表可视化、支持多关键词排序匹配。简单总结:

  • 需要逐个跳转、特别是录制键盘宏时,isearch 更合适
  • 需要一眼看到所有匹配行、用多关键词过滤时,consult-line 更方便
  • 不想装额外包的情况下,配置后的 isearch 已经够用

案例三:Diary vs Org Agenda — 轻量与重量之间

会议中两人讨论了一个选择题:用 Emacs 内置的 Diary 还是 Org Agenda 来管理日程。

Diary 是什么? Diary 是 Emacs 内置的日程管理工具,不依赖任何外部包。它的数据就是一个纯文本文件 ~/diary ,格式简单:

May 23, 2026  团队周会
Monday        每周一的固定检查
%%(diary-float t 1 3)  每月第三个周一的性能报告

其中 diary-float 的参数含义:第一个参数 t 表示所有月份,第二个参数 1 表示周一( 0 是周日, 1 是周一,以此类推),第三个参数 3 表示该月的第 3 个。

Diary 文件可以配合 Emacs 日历( M-x calendar )使用,在日历上标记日程。也可以直接用 M-x diary 查看今天的日程。

Org Agenda 的定位。 Org Agenda 是 Org-mode 的一部分,功能比 Diary 丰富得多:TODO 状态流转、优先级、时间戳、重复任务、多文件聚合视图。代价是必须用 Org 文件管理任务,文件结构有要求(至少需要 TODO 关键词和时间戳)。

各自的适用场景。

  Diary Org Agenda
启动成本 零配置,打开就写 需要结构化的 Org 文件
数据格式 纯文本,一行一条 Org 标题 + 属性 + 时间戳
功能范围 日程标记 + 日历显示 TODO 管理 + 日程 + 时间追踪 + 报表
适合人群 只需要简单日程提醒 需要 GTD 或项目管理级的工作流

Prot 在会议中的观点是:Diary 和 Org Agenda 可以并用。用 Diary 记录简单的时间点事件(节假日、固定会议),用 Org Agenda 管理需要追踪进度的任务。两者都能在 Emacs 日历中显示。

小结

这场会议还讨论了其他话题:Amin 展示了他为个人网站开发的自定义 Org HTML 导出后端(继承自内置的 ox-html ),已有静态站方案的同学可以参考他的思路。

回到核心主题:Emacs 的可扩展性不光体现在"你可以写 Elisp"。很多内置功能本身就暴露了配置接口,从窗口管理( display-buffer-alist )到搜索(isearch 变量)到日程(Diary 格式),不装额外包也能深度定制。这些接口一直都在文档里,这场教练会议只是把它们翻了出来。

Emacs : display-buffer-alist : isearch : diary : org-agenda