1. 项目概述为什么我们需要一个“可配置”的光标在Emacs这个以高度可定制性著称的编辑器中我们几乎可以调整一切主题、字体、键绑定、窗口布局……但有一个细节常常被忽略那就是光标。默认情况下Emacs的光标是一个简单的、可能还在闪烁的竖线或方块。对于长时间编码、写作或阅读的用户来说这个看似微不足道的元素却直接影响着视觉舒适度和专注度。你是否曾在深夜盯着屏幕感觉那个闪烁的光标格外刺眼或者在全屏演示时希望光标能更醒目一些方便观众跟随你的思路这就是cursory这个包要解决的问题。cursory是一个Emacs包它允许你为光标定义多种预设配置。你可以把它想象成给光标准备的“皮肤”或“模式”。每个预设可以独立控制光标的样式是竖线bar、方块box、水平线hbar还是空心方块hollow、闪烁行为是否闪烁、闪烁的频率以及颜色。通过快速切换这些预设你可以为不同的使用场景创建最优的视觉体验。比如在专注写作时你可以切换到一个不闪烁、颜色柔和的光标减少干扰而在向他人演示代码时则可以切换到一个颜色鲜艳、样式醒目的光标让它成为全场焦点。2. 核心设计思路将光标从“状态”提升为“模式”2.1 从“单一属性”到“预设组合”的转变在深入安装和使用之前理解cursory的设计哲学至关重要。传统的Emacs光标配置是分散的、一次性的。你可能会在初始化文件里设置blink-cursor-mode用set-cursor-color改个颜色但这些设置是孤立的、全局的。cursory的核心创新在于它将光标的所有视觉属性打包成一个名为“预设”的配置单元。这种设计带来了几个关键优势场景化切换你可以为“阅读”、“编码”、“演示”、“夜间模式”分别创建预设一键切换无需手动调整多个变量。状态隔离不同预设之间的配置互不干扰。切换到“演示模式”时光标的颜色、闪烁频率会立刻改变切回“编码模式”时又会恢复原状。这比全局修改某个变量要可靠得多。可复现性预设可以被保存、导出、分享。一旦你调校出一套在特定显示器或光照环境下最舒服的配置就可以将其固化下来随时调用。2.2 预设配置的维度解析一个cursory预设主要包含以下几个维度理解它们有助于你创建更符合需求的配置cursory-presets(预设列表)这是核心变量一个关联列表alist定义了所有可用的预设。每个预设是一个键值对键是预设名如reading值是一个属性列表plist包含具体的样式参数。样式 (:cursor-type)决定光标的外观形态。(bar . WIDTH)竖线WIDTH指定宽度像素。(bar . 2)是常见选择清晰不挡字。(box . HEIGHT)实心方块HEIGHT指定高度像素。传统终端风格。(hbar . HEIGHT)水平线位于字符底部。比较独特适合需要横向视觉引导的场景。hollow空心方块。我个人非常喜欢在深色主题下使用它只勾勒出字符的边框非常优雅且不遮挡内容。闪烁 (:blink-cursor-mode,:blink-cursor-interval,:blink-cursor-blinks)控制光标的动态行为。:blink-cursor-modet为启用闪烁nil为禁用。对于需要长时间凝视光标的深度阅读或思考强烈建议禁用闪烁可以显著减轻视觉疲劳。:blink-cursor-interval闪烁间隔秒。默认是0.5秒。你可以调快如0.3让它更活跃或调慢如1.0让它更沉稳。:blink-cursor-blinks闪烁次数后保持显示。设为-1表示无限闪烁设为0则闪烁一次后常亮。这个参数配合间隔可以创造出“闪烁几下后稳定”的引导效果。颜色 (:cursor-color)最直观的视觉属性。可以是任何Emacs识别的颜色名或十六进制值如#ff6b6b。经验之谈颜色的选择应与你的主题形成适度对比但不宜过于刺眼。在深色主题下避免使用纯白色white可以尝试浅灰色#cccccc或主题的高亮色在浅色主题下避免使用纯黑色。注意cursory的预设系统是叠加式的。当你切换到一个预设时它只会修改预设中明确定义的属性。如果一个预设没有指定闪烁间隔那么切换时就不会改变当前的闪烁间隔值。这给了你很大的灵活性但也要求你在定义预设时考虑周全。3. 安装、配置与基础使用3.1 安装与引入假设你使用的是package.el并配置了GNU ELPA或MELPA等仓库安装非常简单;; 在你的初始化文件如 ~/.emacs.d/init.el中 (require package) (add-to-list package-archives (melpa . https://melpa.org/packages/) t) (package-initialize) ;; 安装 cursory ;; M-x package-install RET cursory RET安装后在你的配置文件中引入并激活它(require cursory) ;; 可选设置一个默认预设这样启动Emacs后就会应用 (cursory-set-preset reading) ; 假设你定义了一个叫 reading 的预设3.2 定义你的第一个预设集配置的核心是定义cursory-presets变量。下面是一个包含多种场景的示例配置你可以直接复制并根据喜好修改(setq cursory-presets ( ;; 1. 日常编码/写作模式不闪烁的细竖线保护眼睛 (coding :cursor-type (bar . 2) :cursor-color #51afef ; 一种舒适的蓝色 :blink-cursor-mode nil) ; 关键禁用闪烁 ;; 2. 深度阅读模式空心方块颜色更暗完全静态 (reading :cursor-type hollow :cursor-color #5B6268 ; 深灰色非常低调 :blink-cursor-mode nil) ;; 3. 演示模式醒目的红色粗方块快速闪烁以吸引注意力 (presentation :cursor-type (box . 3) :cursor-color #ff6b6b ; 红色 :blink-cursor-mode t :blink-cursor-interval 0.3 ; 快速闪烁 :blink-cursor-blinks -1) ; 无限闪烁 ;; 4. 复古终端模式模拟老式终端方块闪烁 (retro :cursor-type (box . 1) :cursor-color #98be65 ; 绿色 :blink-cursor-mode t :blink-cursor-interval 0.5) ;; 5. 超大光标模式用于视力辅助或在大屏幕上非常醒目 (large :cursor-type (box . 6) :cursor-color #da8548 ; 橙色 :blink-cursor-mode nil) ))配置要点解析预设名如coding、reading它们是符号symbol通常使用单引号防止被求值。属性顺序属性列表plist中键值对的顺序无关紧要但保持一致性如总是:cursor-type在前有利于阅读。颜色值这里使用了十六进制颜色码它们比颜色名如red更精确能确保在不同终端和GUI下表现一致。你可以使用M-x list-colors-display来浏览和选择Emacs支持的颜色。3.3 切换预设的多种方式定义好预设后有几种方法可以切换交互式命令最常用的方式。按M-x cursory-set-preset RET然后输入预设名如reading即可。Emacs的补全机制通常是TAB键可以帮你快速输入。函数调用在Elisp代码或键绑定中直接调用。(cursory-set-preset presentation) ; 切换到演示模式绑定快捷键为了极致效率可以将常用预设绑定到快捷键上。;; 绑定到 Ctrlc c 加上模式首字母 (global-set-key (kbd C-c c c) (lambda () (interactive) (cursory-set-preset coding))) (global-set-key (kbd C-c c r) (lambda () (interactive) (cursory-set-preset reading))) (global-set-key (kbd C-c c p) (lambda () (interactive) (cursory-set-preset presentation)))与模式钩子联动这是cursory的高级用法可以实现自动化。例如当你进入org-mode写作时自动切换到阅读模式进入prog-mode时切换到编码模式。(add-hook org-mode-hook (lambda () (cursory-set-preset reading))) (add-hook prog-mode-hook (lambda () (cursory-set-preset coding)))注意使用钩子时要小心冲突。如果多个钩子修改了光标预设最后执行的钩子会生效。确保你的配置逻辑清晰。4. 高级技巧与深度定制4.1 根据环境自动选择预设一个更智能的配置是根据系统环境如GUI还是终端、白天还是夜晚自动选择预设。这需要结合其他Emacs功能来实现。示例根据图形界面GUI与终端TTY设置不同预设在终端中某些光标样式如hollow或颜色可能不被支持。我们可以让Emacs在启动时自动判断;; 在初始化文件中在定义cursory-presets之后 (defun my-setup-cursor-by-environment () 根据运行环境设置初始光标预设。 (if (display-graphic-p) ;; 图形界面下使用功能全面的预设 (cursory-set-preset coding) ; 例如使用coding预设 ;; 终端TTY下使用兼容性更好的预设 (cursory-set-preset retro))) ; 例如使用复古终端预设 ;; 在Emacs启动后调用此函数 (add-hook after-init-hook #my-setup-cursor-by-environment)示例根据时间自动切换日间/夜间模式你可以结合now或sunshine等包或者简单地根据小时数来判断(defun my-setup-cursor-by-time-of-day () 根据一天中的时间切换光标预设。 (let ((hour (string-to-number (format-time-string %H)))) (cond ((and ( hour 6) ( hour 18)) ; 白天 6:00 - 17:59 (cursory-set-preset coding)) ; 日间模式 (t ; 夜晚 (cursory-set-preset reading))))) ; 夜间阅读模式 ;; 可以绑定到一个快捷键或定时执行 (global-set-key (kbd C-c c t) #my-setup-cursor-by-time-of-day)4.2 创建“临时”或“覆盖”预设有时你不需要定义一个新的永久预设只是想临时覆盖某个属性。cursory提供了cursory-set-values函数来实现这一点。;; 临时将光标改为不闪烁的红色粗竖线但不影响已定义的预设 (cursory-set-values :cursor-type (bar . 4) :cursor-color red :blink-cursor-mode nil) ;; 如果你想基于当前预设做临时修改可以先获取当前值 (let ((current-preset (cursory-get-preset))) ; 需要cursory最新版本支持此函数 ;; 假设current-preset是一个plist我们可以修改它 (plist-put current-preset :cursor-color orange) (apply #cursory-set-values current-preset))这个功能在调试配置或进行一次性调整时非常有用。要恢复到最后一次通过cursory-set-preset设置的预设只需再次调用该命令即可。4.3 与其他流行包集成cursory可以很好地与Emacs生态中的其他包协同工作创造出更统一的体验。与theme/modus-themes集成Protesilaoscursory的作者也是著名主题modus-themes的作者。你可以让光标颜色自动匹配当前主题的强调色。(defun my-cursor-color-from-theme () 从当前主题中提取一个颜色作为光标色。 ;; 这是一个示例实际颜色提取逻辑取决于你的主题 (let ((accent-color (face-attribute mode-line :background))) ; 例如取模式行的背景色 (cursory-set-values :cursor-color accent-color))) (add-hook after-load-theme-hook #my-cursor-color-from-theme)与eyebrowse或perspective集成如果你使用工作区管理包可以为不同的工作区设置不同的光标预设强化视觉上下文。;; 假设使用eyebrowse (add-hook eyebrowse-post-window-switch-hook (lambda () (let ((workspace (eyebrowse-get-current-window-config))) (pcase workspace (1 (cursory-set-preset coding)) (2 (cursory-set-preset reading)) (_ (cursory-set-preset default))))))5. 常见问题与排查实录即使配置得当你也可能会遇到一些问题。下面是我在长期使用中遇到的一些典型情况及其解决方法。5.1 问题切换预设后光标样式没有立即改变可能原因1缓冲区的局部变量覆盖。某些模式如term-mode、eshell或缓冲区可能设置了局部变量cursor-type其优先级高于全局设置。排查将光标移动到不同的缓冲区如*scratch*看看是否改变。使用C-h v cursor-type查看当前缓冲区的局部值。解决你可以强制在所有缓冲区应用或在特定模式的钩子中重新应用预设。cursory的cursory-set-preset默认只设置全局变量但局部变量可能会覆盖它。一个变通方法是(defun my-cursory-set-preset-force (preset) 强制在所有缓冲区应用PRESET。 (interactive (list (intern (completing-read Preset: (mapcar #car cursory-presets))))) (cursory-set-preset preset) ;; 遍历所有存活缓冲区设置局部变量谨慎使用可能影响性能 ;; (dolist (buf (buffer-list)) ;; (with-current-buffer buf ;; (when (not (eq major-mode term-mode)) ; 排除终端等特殊模式 ;; (setq-local cursor-type (plist-get (alist-get preset cursory-presets) :cursor-type)))))) )5.2 问题在终端TTY中某些光标样式不生效或显示异常可能原因终端模拟器对光标样式的支持有限。例如许多终端不支持hollow空心方块样式可能将其渲染为实心方块或竖线。排查在GUI版本的Emacs如Emacs for MacOS、GTK版本中测试相同的预设。如果GUI下正常而终端下异常就是终端兼容性问题。解决为终端单独定义预设如前文所述使用(display-graphic-p)判断并为终端使用更兼容的样式如(bar . 2)或(box . 1)。检查终端配置有些终端如iTerm2、Alacritty可以在其配置中启用“光标形状变化”支持。查阅你的终端文档。降级使用在终端中坚持使用bar和box这两种最广泛支持的样式。5.3 问题光标闪烁频率不稳定或不符合设定值可能原因1blink-cursor-blinks参数的影响。如果该值设为一个较小的正数如5光标在闪烁指定次数后就会保持常亮给人一种“闪烁停止”的错觉。排查检查你的预设中:blink-cursor-blinks的值。设为-1表示无限闪烁。可能原因2系统性能或Emacs垃圾回收GC。在Emacs非常繁忙进行大量计算、渲染复杂缓冲区时定时器可能不精确导致闪烁看起来卡顿。排查观察在轻负载如空缓冲区和重负载打开大文件、运行M-x compile时光标闪烁的表现。解决对于性能问题尝试增加Emacs的GC阈值gc-cons-threshold但这只是权宜之计。更根本的是优化你的配置和避免在Emacs中运行过于繁重的任务。5.4 问题如何查看当前生效的所有光标设置解决Emacs提供了多个命令来检查状态。M-x describe-variable RET cursor-type RET查看当前缓冲区的光标类型。M-x describe-variable RET cursor-color RET查看当前缓冲区的光标颜色。M-x describe-variable RET blink-cursor-mode RET查看闪烁模式是否启用。M-x cursory-get-preset如果可用直接获取当前cursory预设的名称。更直接的方法是查看cursory-latest-preset这个变量的值它记录了最后一次通过cursory-set-preset设置的预设名。5.5 问题配置不生效或者加载时报错可能原因1加载顺序问题。如果你在cursory包加载之前就引用了cursory-presets变量或者调用了cursory-set-preset函数会导致错误。解决确保所有cursory相关的配置都放在(require cursory)之后。使用with-eval-after-load是一个好习惯可以确保配置在包加载完成后才执行。(with-eval-after-load cursory (setq cursory-presets (...)) ; 你的预设配置 (cursory-set-preset coding)) ; 设置默认预设可能原因2预设定义语法错误。确保cursory-presets是一个正确的alist每个元素是(SYMBOL . PLIST)的形式且PLIST的键是关键字以冒号开头。排查使用M-x ielm进入Elisp交互模式逐段评估你的配置看是否有错误提示。6. 性能考量与最佳实践cursory本身非常轻量切换预设的操作是即时的开销可以忽略不计。但在大规模、自动化的配置中仍需注意以下几点避免在频繁触发的钩子中切换预设例如不要在每个post-command-hook或window-configuration-change-hook中调用cursory-set-preset这可能导致不必要的重绘和轻微卡顿。预设数量适度定义5-10个最常用的预设即可。过多的预设虽然不会影响性能但会增加管理复杂度。颜色选择要兼顾美学与可读性光标颜色应与语法高亮、模式行等界面元素协调。避免使用与背景色对比度过低或过高的颜色。可以使用在线配色工具或Emacs内置的M-x list-colors-display来挑选。为“禁用闪烁”设置一个专用预设这是我个人的首要建议。无论你创建多少预设一定要有一个禁用闪烁的选项:blink-cursor-mode nil。长时间面对闪烁的光标是导致视觉疲劳的主要原因之一。我90%的时间都使用不闪烁的光标预设。分享与备份你的配置一旦你调校出一套适合自己的预设不妨将其分享到你的配置仓库如GitHub Gist或社区。这既是备份也可能帮助到有类似需求的人。光标是你在文本世界中的“指针”是注意力锚定的地方。花一点时间通过cursory来优化它的外观和行为是对自己长时间屏幕工作的一种体贴。从今天开始尝试创建一个属于你自己的、不闪烁的“专注模式”光标吧你的眼睛会感谢你。