Sublime Text 的代码补全面板可见行数由 auto_complete_max_height 像素值控制,需在 Settings – UI 中设置,如 "auto_complete_max_height": 600;其效果受字体大小、主题样式及 LSP 插件影响,并非直接设定行数。

Sublime Text 的代码补全面板(AutoComplete)默认最多显示 12 行候选,超出会加滚动条。想直接看到更多建议?关键不是改某个“行数参数”,而是调整 auto_complete_max_height 这个 UI 控制值——它决定面板最大像素高度,间接控制可见行数。
auto_complete_max_height 是什么,为什么它管用
这个设置不控制“行数”本身,而是限制补全面板的像素高度(单位:px)。Sublime 内部按每行约 24px 渲染(含 padding),所以设为 480 理论上能显示约 20 行。它属于 UI 层配置,必须写在 Preferences.sublime-settings(UI 设置)里,写在语法或插件设置中无效。
常见误区是去搜 max_shown 或 completion_lines ——这些根本不存在。
怎么修改 auto_complete_max_height
打开 Sublime Text → Preferences → Settings – UI,在右侧用户设置面板中添加或修改:
{
"auto_complete_max_height": 600
}
保存后无需重启,补全面板下次弹出即生效。建议值范围:360(约 15 行)到 720(约 30 行),再高可能遮挡编辑区或触发系统滚动条干扰操作。
- 如果用的是 Sublime Text 4,确认你编辑的是
Settings – UI,不是Settings – Syntax - 该值对所有语言、所有补全源(snippet、symbol、LSP)统一生效
- 若同时装了 LSP 插件(如
sublimelsp),它的补全面板高度由 LSP 自身控制,auto_complete_max_height不影响它
补全面板变高后,为什么有些行还是看不清
真实可见行数还受字体大小、行高、主题 padding 影响。比如使用 Monospace 字体 + font_size: 14 + line_padding_top: 3,实际每行占约 28px,那么 600 只能显示约 21 行,不是整除的 24px × 25 = 600。
更隐蔽的问题是:部分 UI 主题(如 Adaptive 或第三方主题)会重写补全面板样式,覆盖 auto_complete_max_height 效果。此时需检查主题的 Widget.sublime-settings 文件中是否有 auto_complete 相关 height 覆盖。
真正起作用的只有 auto_complete_max_height,但它不是万能的——字体、主题、LSP 插件都会绕过它。调得太高反而让面板挡住光标,不如先试 480,再根据实际显示微调。










