Repolode
minad

minad/vertico

Emacs 的极简垂直补全界面,基于内置补全系统,兼容原生补全命令。

Star
1,896
Fork
76
未关闭 Issue
0
最近提交
27天前

这是什么?

Vertico 是 Emacs 迷你缓冲区(minibuffer)的补全界面,以垂直列表展示候选项。它复用 Emacs 内置的补全机制,而不是另起一套 API,因此已经支持 completing-read 的命令和补全表在 Vertico 下行为一致。

它支持方向键导航、TAB 插入当前候选、RET 选中,以及用 M-RET 提交候选列表之外的输入。候选项可按历史记录、使用频率、长度或字母顺序排序,也支持分组和注释显示。可选扩展提供平铺、网格、反向、缓冲区等多种显示模式,并可通过 vertico-multiform 为不同命令或补全类别单独配置。

Vertico 只负责界面,通常与 Orderless(匹配)、Marginalia(注释)、Consult(搜索和导航命令)、Embark(对候选项执行操作)等配套包组合使用。

核心功能

  • 01垂直候选列表,支持方向键导航,提示符中显示当前序号和总数。
  • 02基于 Emacs 内置补全机制,现有补全命令无需修改即可使用。
  • 03支持按历史记录、使用频率、长度或字母顺序排序。
  • 04通过扩展提供平铺、网格、反向、缓冲区等显示模式。
  • 05通过 vertico-multiform 按命令或补全类别单独配置显示方式。

适用场景

  • 在 Emacs 中通过垂直列表选择文件、缓冲区或命令。
  • 与 Orderless 和 Consult 搭配,在迷你缓冲区中实现灵活搜索和导航。
  • 以更小、更易组合的方式替代 Ivy 等补全框架。

快速上手

  1. 1

    通过 M-x package-install 从 ELPA 或 MELPA 安装 Vertico

    M-x package-install RET vertico RET
  2. 2

    启用全局次要模式

    M-x vertico-mode RET

使用前须知

  • 仅适用于 Emacs:它是供 Emacs 编辑器使用的 Emacs Lisp 包。

标签

常见问题

vertico 是什么?
Emacs 的极简垂直补全界面,基于内置补全系统,兼容原生补全命令。 Vertico 是 Emacs 迷你缓冲区(minibuffer)的补全界面,以垂直列表展示候选项。它复用 Emacs 内置的补全机制,而不是另起一套 API,因此已经支持 completing-read 的命令和补全表在 Vertico 下行为一致。
vertico 可以免费使用吗?用的什么许可证?
vertico 以 GPL-3.0 许可证开源。用于商业产品前,请先确认许可证条款。
vertico 还在维护吗?
活跃维护中。vertico 最近一次提交是在 2026年10月11日。
vertico 适合用来做什么?
在 Emacs 中通过垂直列表选择文件、缓冲区或命令。 与 Orderless 和 Consult 搭配,在迷你缓冲区中实现灵活搜索和导航。 以更小、更易组合的方式替代 Ivy 等补全框架。
vertico 怎么安装和运行?
通过 M-x package-install 从 ELPA 或 MELPA 安装 Vertico: M-x package-install RET vertico RET 启用全局次要模式: M-x vertico-mode RET
在哪里获取 vertico?
源代码和安装说明在 GitHub 上:https://github.com/minad/vertico

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目