sublime默认不将“.”视为python补全触发符,需手动配置auto_complete_triggers:{"selector": "source.python", "characters": "."}。

为什么输.没反应?先看auto_complete_triggers配对没
Sublime 默认不把 . 当作补全触发字符,哪怕你装了 LSP-pyright 或 pylsp,os. 后也不会弹框——除非在用户设置里显式告诉它:“在 Python 文件里,遇到点号就该唤出补全”。这靠的是 auto_complete_triggers 数组,不是靠插件自动猜。
正确写法(贴进 Preferences → Settings 右侧 User 面板):
"auto_complete_triggers": [
{"selector": "source.python", "characters": "."},
{"selector": "source.css", "characters": ":"},
{"selector": "text.html.basic", "characters": "
<p>注意三点:</p>
-
selector必须精准匹配当前文件的语法 scope,比如 Python 文件得是source.python,不是source.python.3或source.py;右下角显示 “Python” 才对,显示 “Python 3” 就会失效 -
characters是字符串,不是正则,只支持单字符("."可以,". "不行) - 多个语言要分开写对象,不能合并成一个
{"selector": "source.python, source.css", ...}—— Sublime 不认这种逗号分隔写法
source.python 这个 scope 怎么查?别靠猜
scope 写错,auto_complete_triggers 就等于没写。最稳的办法是现场查:打开一个 .py 文件,按 Ctrl+Shift+P → 输入 Developer: Show Scope Name 回车,光标所在位置顶部状态栏就会显示完整 scope 链,例如 source.python meta.function.python。取最前面那个 source.python 就够用。
常见陷阱:
- CSS 文件显示的是
source.css,不是source.css.3或source.scss(SCSS 要另配) - .vue 文件默认是
text.html.vue,如果想让<script></script>块内也响应.,得加一条{"selector": "source.python.embedded.html", "characters": "."} - HTML 中想触发标签补全,用
text.html.basic,不是text.html(后者不生效)
Tab 键不确认补全?缺这行设置
就算 auto_complete_triggers 配对了、LSP 也跑起来了,按 Tab 依然只缩进不选中补全项——因为 Sublime 默认禁用 Tab 提交补全。必须手动启用:
"auto_complete_commit_on_tab": true
顺带一提,如果你还用了代码片段(.sublime-snippet),建议一起加上:
"auto_complete_with_fields": true
否则像 for 片段里的 ${1:iterable} 无法用 Tab 跳转。
若仍无效,临时禁用 AutoFileName 或 All Autocomplete 类插件——它们常劫持 Tab 行为,且错误优先级高于原生设置。
LSP 补全和触发词是两回事:先确保服务器真在跑
auto_complete_triggers 只负责“什么时候弹框”,不负责“框里有什么”。如果弹出的只是文件内变量名,没有 str.split() 或 requests.get(),说明 LSP 服务器根本没加载成功。
检查步骤:
- 右下角状态栏是否显示
LSP-pyright active(或LSP-pylsp)?没出现就代表客户端没连上 - 终端执行
pyright --version或pylsp --version,有输出才说明命令可用 - LSP.sublime-settings 中对应语言的
"command"必须是绝对路径(如["/opt/homebrew/bin/pyright"]),不能只写["pyright"](除非确认它在系统$PATH里) - Python 项目需有
pyproject.toml或setup.py,否则 pyright 可能退化为无类型补全
真正麻烦的不是配置项写错,而是 LSP 启动慢、静默失败、或 scope 匹配失败后连日志都不报——这些地方最容易卡住半天找不到原因。











