tab键不补全需先确认auto_complete_commit_on_tab为true,否则仅插入缩进;该设置生效后,tab才提交高亮补全项,但对emmet、autofilename等插件无效。

Tab键不补全,先确认auto_complete_commit_on_tab是否为true
Sublime 默认按 Tab 只插缩进,不是“选中补全项”,哪怕补全框已经弹出来。很多人关了又开、重装插件,最后发现只是漏了这一个开关。
必须在 Preferences → Settings(右侧用户设置)中显式写入:
"auto_complete_commit_on_tab": true
这个配置生效后,才满足“补全框弹出 + Tab = 确认高亮项”的基本前提。它对原生单词补全、LSP 补全、.sublime-completions 文件都起作用,但对 AutoFileName、Emmet 这类监听按键事件的插件无效——它们走的是另一套逻辑。
常见误判点:
- 看到补全框没反应,第一反应是检查 LSP 是否启动,其实应先查这个布尔值
- 改完保存但没生效?可能是 JSON 格式错误(比如多逗号、引号不匹配),整段设置会被静默忽略
- 开了它,但 Tab 仍只缩进?说明补全框根本没弹出来,问题不在提交逻辑,而在触发条件
补全框不弹,重点看auto_complete_triggers和auto_complete_selector
即使 auto_complete 设为 true,Sublime 也不会无脑弹窗——它靠 auto_complete_selector 判断“当前光标位置是否允许补全”,再靠 auto_complete_triggers 决定“输入什么字符时触发”。两者都错配,Tab 就永远只是 Tab。
典型 Python 场景配置示例(放在用户设置或语法专属设置中):
"auto_complete_triggers": [
{"selector": "source.python - string - comment", "characters": "."}
],
"auto_complete_selector": "source.python"
说明:
-
source.python - string - comment表示:只在 Python 代码主体中(排除字符串、注释),输入.才自动弹窗 -
auto_complete_selector是兜底范围,如果这里写了text.plain,那所有纯文本文件都会尝试补全,容易误触 - JavaScript 要用
source.js,不能复用 Python 的 selector;大小写、前缀(必须是source.)都不能错 - 修改后已打开的文件需切换 tab 或执行
Ctrl+Shift+P → Reload Snippets才刷新生效
多个补全源共存时,Tab 提交谁?优先级由auto_complete_selector和插件权重决定
当你同时装了 LSP、TabNine、All Autocomplete,按下 Tab 后补全项来自哪?Sublime 不按“安装顺序”或“启用先后”排序,而是:
- 先按
auto_complete_selector过滤当前 scope,筛掉不匹配的补全源 - 再根据各插件注册的
on_query_completions返回权重(priority字段),高者前置 - LSP 插件通常设较高 priority,TabNine 默认较低,所以常出现“函数签名被压到第二页”
想让 Tab 优先提交 LSP 建议(比如带参数提示的函数):
- 确保
auto_complete_selector包含source.python(不要宽泛写成source) - 禁用 TabNine 的自动弹窗:
Preferences → Package Settings → TabNine → Settings中加"disable_auto_insert": true - 保留
auto_complete_with_fields为true,否则 LSP 的参数占位符(如func(${1:arg}))无法展开
注意:auto_complete_with_fields 和 auto_complete_commit_on_tab 共存时,Tab 会先展开字段再提交,不是冲突关系,但若字段未填完就换行,可能残留 ${1:...}。
Emmet 和括号自动补全会劫持 Tab,它们不走auto_complete_commit_on_tab
如果你在 HTML/CSS 中敲 div.test 后按 Tab,生成了 <div class="test"></div>,这不是原生补全在工作,而是 Emmet 直接拦截了按键事件。同理,auto_match_enabled 控制的括号/引号补全也完全独立于补全系统。
解决路径很明确:
- 关 Emmet 的 Tab 触发:
Preferences → Package Settings → Emmet → Settings,设"disable_auto_insert": true,或删掉"tab_key_activation"配置项 - 关括号自动补全:
"auto_match_enabled": false(但注意,这不会影响match_brackets的高亮行为) - 验证是否干净:新建一个空
.txt文件,输入abc后按 Tab —— 应只插入缩进,不弹窗、不展开、不补标签
最容易被忽略的是:Emmet 和括号补全是“按键级劫持”,哪怕你把所有 auto_complete* 相关设置全关掉,它们依然能响应 Tab。排查时得从插件自身设置入手,而不是反复调编辑器补全开关。











