Vertico项目中的垂直窗口大小调整行为解析

在Emacs生态系统中，Verico作为一个现代化的补全框架，提供了多种补全界面风格。其中vertico-flat模式模拟了类似ido的扁平化补全体验，但在窗口大小调整行为上与原生ido存在一些值得注意的差异。

问题现象

当用户启用vertico-flat-mode并设置vertico-flat-max-lines大于1时，即使配置了(setq vertico-resize 'grow-only)，补全窗口在候选项目减少时仍会垂直收缩。这种行为与ido-mode保持窗口只增不减的特性形成对比，可能导致用户视觉焦点频繁跳动。

技术背景

Verico通过vertico-flat.el实现扁平化补全样式，其核心机制是：

1. 禁用truncate-lines以确保长候选项能完整显示
2. 使用overlay在minibuffer尾部显示候选列表
3. 动态调整窗口大小以适应内容变化

行为差异的根源

深入分析代码发现，vertico-flat-mode在显示候选列表时强制设置了resize-mini-windows为t（允许自由调整），覆盖了用户配置的grow-only设置。这是设计上的有意为之，主要考虑因素包括：

1. 多形态补全场景下的一致性体验
2. 扁平模式通常期望候选项单行显示
3. 最小化垂直空间占用原则

解决方案比较

虽然默认行为有其设计考量，但对于习惯ido-style的用户，可通过以下方式实现只增不减的效果：

1. 直接修改法（需维护成本）： 修改vertico-flat.el源码，移除对resize-mini-windows的强制设置

2. 配置覆盖法：

   (setq vertico-multiform-commands
         '((execute-extended-command flat (resize-mini-windows . t))))
   

3. 建议拦截法（推荐）：

   (defadvice vertico--display-candidates (after reset-resize-mini-windows compile)
     (setq resize-mini-windows vertico-resize))
   

设计哲学探讨

这一现象反映了补全框架设计中的平衡艺术：

• 一致性 vs 可定制性
• 空间效率 vs 视觉稳定性
• 默认体验 vs 特殊需求

Verico选择了为多形态补全优化默认行为，同时通过灵活的扩展机制（如advice）保留用户定制空间，这种设计思路值得Emacs插件开发者借鉴。

最佳实践建议

对于不同需求的用户：

1. 空间敏感型：保持默认设置，享受动态调整的空间效率
2. 视觉稳定型：使用建议机制强制grow-only行为
3. 混合需求型：通过vertico-multiform为不同命令配置不同行为

理解这些底层机制不仅能解决具体问题，更能帮助用户根据自身工作流打造最优的补全体验。