Sublime Text如何自定义自动补全规则_Sublime自定义自动补全规则教程

Sublime Text如何自定义自动补全规则

如果你在Sublime Text里写Python，可能会发现一个尴尬的情况：输入os.之后，光标就那么干等着，期待中的方法列表迟迟不肯出现。这其实不是软件坏了，而是Sublime Text的一个“特性”——它原生并不主动解析语法结构。想让点号触发补全，你必须明确地告诉它：“嘿，在这个场景下，你得干活了。”而这个指令，就藏在auto_complete_triggers这个设置项里。

怎么让 . 触发 Python 补全

默认情况下，Sublime Text只在空格、换行或某些标点后才会扫描单词，点号并不在它的监听列表里。要让它在输入.后弹出补全，你得在用户设置里手动添加一条规则。这里有几个关键点，一个都不能错：

• selector必须精确匹配：这里要填source.python。注意，既不是text.python，也不是简简单单的python，前缀和大小写都必须严格一致。
• characters就是触发符：填入"."即可，记住，它就是一个普通的字符串，不是正则表达式。
• 支持多语言：如果你还需要在Ja vaScript里实现同样的效果，只需追加一个对象，比如{"selector": "source.js", "characters": "."}。
• 修改后记得刷新：设置保存后，已经打开的.py文件需要切换一下标签页再切回来，或者更直接一点，按Ctrl+Shift+P，然后输入Reload Snippets来刷新缓存。

为什么补全没反应？常见失效原因

规则配了，但补全窗口就是弹不出来？别急，这种情况十有八九是下面几个环节出了岔子：

• 检查右下角语法标识：如果文件右下角显示的是Plain Text，那么所有与语言相关的补全（包括插件提供的）都会静默失效。你必须手动点一下，把它切换回Python。
• auto_complete_selector范围太窄：这个设置决定了在哪些地方可以触发补全。如果它被设置得过于狭窄（比如只写了"source"），而你的文件实际scope可能是source.python.embedded，那就匹配不上了。通常改成"source, text"会更保险。
• 插件冲突：一些插件，比如Vintage（Vi模拟模式）或者旧版本的Emmet，可能会劫持键盘输入事件。可以尝试临时禁用它们，看看问题是否解决。
• Scope不匹配的终极排查：最可靠的方法是按Ctrl+Shift+P，输入Developer: Show Scope Name，查看光标所在位置的实际scope是什么，然后回头核对auto_complete_triggers里写的selector是否与之匹配。

自定义补全文件怎么写才生效

除了触发规则，你可能还想创建自己的代码片段，比如输入prn就自动展开为print()。这需要创建.sublime-completions文件，这里面的门道也不少：

• 文件必须放在正确的位置：它应该位于Packages/User/目录下。通过Preferences → Browse Packages…菜单可以快速打开这个文件夹。
• 文件名有固定格式：必须以.sublime-completions结尾，例如python-custom.sublime-completions。
• scope字段是关键：这个字段决定了你的补全在什么语法环境下生效。如果写错了scope（比如该写source.python却写成了text），那么补全就永远不会触发。
• 内容格式有讲究：trigger是触发词，contents是替换后的内容。你可以使用$1、$0这样的占位符来定义光标跳转位置，但要注意，Sublime Text不支持像${1:default}这种带默认值的复杂占位符。
• JSON语法必须严格合法：这是最容易踩坑的地方。文件末尾不能有多余的逗号，所有字符串必须用双引号。一旦JSON格式有误，整个文件都会被Sublime Text默默忽略。

要不要装 LSP？Python 补全绕不开它

说到这里，必须提一个根本性的限制：Sublime Text原生的补全机制，本质上只是基于文本的单词匹配。这意味着，即便你成功配置了点号触发，当你输入import requests后，再打requests.，你依然看不到get、post这些方法列表——这并非配置错误，而是原生能力的边界。

• 远离已过时的方案：首先，不建议再尝试SublimeCodeIntel。这个插件已多年未维护，对Python 3.11+的新语法和现代类型注解（如Self、LiteralString）基本没有响应，还经常导致编辑器卡顿。
• 拥抱LSP生态：当前的主流和最佳选择，是安装LSP插件，再搭配Python的语言服务器，比如LSP-pyright或LSP-pylsp。具体步骤是：先通过Package Control安装LSP插件，然后在系统终端里pip install pyright或pip install ‘python-lsp-server[all]’。
• 补全不会立刻出现：安装配置好后，需要一点耐心。当你打开一个Python文件，留意编辑器右下角，直到出现类似LSP-pyright active的提示（通常需要2到5秒），这表示语言服务器已经加载就绪，此时才能真正享受到基于语义分析的智能补全。
• 仔细检查路径配置：一个常见的疏忽是路径问题。务必确认LSP.sublime-settings配置文件里，"command"字段指向的pyright可执行文件确实存在，并且有执行权限。

说到底，Sublime Text的补全逻辑高度依赖于文件的scope和右下角的语法标识。很多时候问题不出在auto_complete这个总开关上，而恰恰是这两个最基础的环节被忽略了。理解这一点，排查问题就能有的放矢了。