Emacs company-mode 如何实现无弹窗自动插入式补全循环切换
基于company-mode实现无弹窗循环补全的配置方案
核心逻辑调整思路
要实现要求的交互,需要改动两个company默认的行为:
- 完全移除所有弹窗类的前端渲染组件,从根源上杜绝补全提示窗口的弹出
- 暂存初始输入的前缀和匹配到的全部候选,后续按TAB切换时始终基于原始前缀取候选,不会把已插入的补全文本当成新的匹配起点,且全程不移动光标位置。
具体配置步骤
1. 关闭所有弹窗和自动触发逻辑
首先调整company的基础配置,从入口切断所有弹窗触发路径:
;; 仅保留无弹窗的TNG交互前端,移除默认的候选列表浮层、文档预览、悬浮提示组件 (setq company-frontends '(company-tng-frontend)) ;; 关闭空闲自动补全,完全由TAB按键手动触发补全流程 (setq company-idle-delay nil) ;; 降低前缀触发长度阈值,输入任意长度的字符按TAB都可以匹配候选 (setq company-minimum-prefix-length 1)
这一步配置完成后,company运行过程中不会弹出任何形式的补全提示窗口,所有候选计算都在后台完成。
2. 实现基于原始前缀的循环切换补全函数
company默认的补全逻辑存在偏差:第一次补全插入print后,第二次按TAB时会把print作为新的前缀重新匹配候选,不符合需求。通过自定义交互函数暂存补全过程的状态,解决这个问题:
;; 定义暂存补全状态的全局变量 (defvar my/company-original-prefix nil "暂存第一次触发补全时的原始输入前缀") (defvar my/company-candidate-list nil "暂存当前前缀匹配到的全部补全候选") (defvar my/company-current-candidate-index nil "暂存当前选中的候选在列表中的下标") (defun my/company-clear-state-on-move () "当光标主动离开补全区域时,清空所有暂存的补全状态" (when my/company-original-prefix (save-excursion (goto-char (point-min)) (unless (looking-back (regexp-quote my/company-original-prefix) (- (point) (length my/company-original-prefix))) (setq my/company-original-prefix nil my/company-candidate-list nil my/company-current-candidate-index nil) (remove-hook 'post-command-hook #'my/company-clear-state-on-move))))) (defun my/company-tab-cycle () "TAB键触发的无弹窗循环补全逻辑" (interactive) ;; 如果没有暂存的补全状态,判断当前位置是否有可匹配的前缀 (if (null my/company-current-candidate-index) (let* ((current-prefix (company-grab-prefix)) (candidates (when current-prefix (company-candidates current-prefix)))) ;; 没有匹配到候选时,执行原生TAB缩进功能 (if (or (null candidates) (null current-prefix)) (indent-for-tab-command) ;; 初始化补全状态 (setq my/company-original-prefix current-prefix) (setq my/company-candidate-list candidates) (setq my/company-current-candidate-index 0) ;; 插入第一个匹配候选 (insert (nth my/company-current-candidate-index my/company-candidate-list)) ;; 注册光标移动的状态清理钩子 (add-hook 'post-command-hook #'my/company-clear-state-on-move))) ;; 已有补全状态时,先删除上一次插入的补全内容(保留原始前缀) (let* ((current-candidate (nth my/company-current-candidate-index my/company-candidate-list)) (delete-length (- (length current-candidate) (length my/company-original-prefix)))) (delete-region (- (point) delete-length) (point)) ;; 循环切换到下一个候选 (setq my/company-current-candidate-index (mod (1+ my/company-current-candidate-index) (length my/company-candidate-list))) ;; 插入新的候选 (insert (nth my/company-current-candidate-index my/company-candidate-list)))))
这个函数的运行效果完全匹配需求:
- 输入前缀比如
pr后按TAB,后台自动匹配所有以pr开头的候选,直接插入第一个匹配项(比如print),全程无弹窗 - 连续按TAB时,会自动删除上一次补全时加在原始前缀后面的内容(比如
print里的int部分),回到pr的原始输入位置,插入下一个匹配pr开头的候选,不会把print当成新的匹配起点 - 光标始终停在插入文本的末尾,不需要手动移动
- 候选列表循环到头时,再按TAB会自动回到第一个候选,实现循环切换的效果
- 没有匹配到候选时,TAB会执行原生的缩进功能,不会影响日常编辑
3. 绑定TAB键触发自定义逻辑
在company-mode激活时,把TAB键的默认补全行为替换成自定义的循环函数:
(add-hook 'company-mode-hook (lambda () (local-set-key (kbd "TAB") #'my/company-tab-cycle)))
内容的提问来源于stack exchange,提问作者comonadd
相关产品推荐
相关产品推荐

