补全框太小是因 Sublime 默认未配置高度,需手动设置 auto_complete_max_height(单位像素,推荐 240 起),该参数与 font_size 无关,且须写在用户设置右栏;若失效,需检查 auto_complete 是否启用、插件是否冲突及语法作用域影响。

补全框太小不是字体问题,而是 Sublime 默认没配高度,必须手动加 auto_complete_max_height 才能撑开。
为什么改了 font_size 补全框还是挤成一条线
补全框的显示高度和编辑区字体大小完全无关。font_size 只影响代码正文,对补全弹窗、命令面板、侧边栏等 UI 元素无效。补全框默认高度由内部逻辑硬编码限制,不设参数时通常只显示 4–5 行,再多就滚动——但滚动条本身又极窄,容易误判为“没内容”。
-
auto_complete_max_height是唯一控制补全框最大行数的配置项,单位是像素,不是字号或行数 - 值设太小(如
100)仍会压扁;推荐从240起调,高分屏可试320 - 必须加在用户设置右栏(
Preferences → Settings右侧 JSON),左栏 Default 设置会被覆盖 - 某些 UI 主题(如 Soothe、Ayu)会重写补全样式,若生效异常,先切回
Adaptive主题验证
auto_complete_max_height 和其他补全相关设置怎么共存
这个参数不是孤立生效的,它和几个关键设置存在隐性依赖关系:
- 如果
"auto_complete": false,再大的max_height也没用——补全框根本不会弹 -
"auto_complete_delay": 0配合大高度,会让补全框响应更快、更稳定,避免“刚弹出就消失” -
"auto_complete_commit_on_tab": true必须启用,否则即使框变高了,按Tab仍只缩进不选中 - 禁用
AutoFileName或All Autocomplete插件,它们会劫持补全逻辑,导致高度设置失效
补全框宽度不能调?其实是被语法作用域卡死了
Sublime 不提供直接设补全框宽度的配置项,但实际宽度取决于当前文件的语法作用域(scope)。比如:
- HTML 文件里输入
触发的补全,宽度由text.htmlscope 决定 - Python 文件里输
.后的补全,宽度受source.pythonscope 影响 - 如果补全框在某类文件中特别窄(比如 Markdown 里突然弹出超长路径),大概率是
auto_complete_selector设成了"source, text",让补全逻辑误入非代码上下文 - 建议拆开写:只对
source开启补全,text类型单独用auto_complete_triggers控制触发字符
真正难调的不是数值本身,而是补全框高度和语言服务器响应速度之间的节奏——LSP-pyright 启动慢半秒,你调再高的 max_height,框也会先闪一下窄的再撑开。这时候得配合 "lsp_format_on_save": false 这类 LSP 子配置一起压测。











