必须先安装package control,再通过它安装lsp插件(作者sublimelsp)及对应语言服务器(如lsp-pyright),接着手动执行“lsp: enable language server globally”启用语言服务,并配置enabled_languages、show_symbol_descriptions等参数及auto_complete相关设置,最后验证语法识别与补全内容质量。

Sublime Text 4 默认不提供 IDE 级代码补全,装上 LSP 插件只是第一步,真正起作用的是配套的语言服务器——没它,LSP 客户端就是个哑巴,不会报错,也不会提示。
必须先确认 Package Control 已安装
没有 Package Control,后续所有插件安装都会失败。按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Package Control: Install Package 能正常出现即表示已就位;若提示 “command not found”,说明还没装。
手动安装方式(仅需一次):打开 View → Show Console,粘贴以下代码并回车:
import urllib.request,os,hashlib; h = '6f4c264a24d933ce70df5dedc1ef834e' + '93b4419234e2c14c786c95a396a27d5f'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); by = urllib.request.urlopen('http://packagecontrol.io/' + pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); print('Error validating download (got %s instead of %s), please try manual install' % (dh, h)) if dh != h else open(os.path.join(ipp, pf), 'wb').write(by)
执行成功后重启 Sublime Text。
LSP 插件和语言服务器要分两步装,缺一不可
LSP 是通用客户端,只负责通信;真正干活的是语言服务器(如 pyright、typescript-language-server)。直接装裸服务器(比如用 npm install -g typescript-language-server)容易因路径未识别而静默失效。
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 搜索并安装LSP(作者 sublimelsp) - 再搜
LSP-pyright(推荐 Python)、LSP-typescript(TS/JS)等封装包——它们自带下载逻辑和默认配置,省去手动配command路径的麻烦 - 不要同时启用 Anaconda 和 LSP-pyright:两者会争抢补全服务,导致签名不显示、CPU 占用飙升;冲突时优先禁用
LSP或LSP-pyright
关键配置项必须手动加进用户设置
装完插件不代表自动生效。LSP 默认不启用任何语言,也不展示参数文档,必须显式开启并调参。
打开 Preferences → Package Settings → LSP → Settings,在右侧用户设置中加入:
{
"enabled_languages": ["python", "javascript", "typescript"],
"show_symbol_descriptions": true,
"show_documentation": true,
"log_debug": false
}
同时检查全局设置 Preferences → Settings(用户侧)是否含以下三项:
-
"auto_complete": true(否则补全框根本不出) -
"auto_complete_commit_on_tab": true(否则按Tab只是缩进,不是确认补全) -
"auto_complete_with_fields": true(否则obj.后的补全可能延迟或不触发)
验证是否真生效:别只看弹窗,要看内容质量
补全菜单弹出来不等于 LSP 在工作。原生补全也弹窗,但只列当前文件里出现过的单词;LSP 补全应带类型、参数签名、docstring 提示。
测试方法:
- 新建
test.py,确保右下角语法显示为Python(不是Plain Text) - 写
import os,然后输入os.+Ctrl+Space - 正确响应:立即列出
os.path、os.listdir()等,括号内有参数提示,悬停能看到 docstring - 失败表现:只列几个变量名、无括号、无描述、或压根不响应 —— 先查语法 scope,再查
LSP → Settings中是否启用了python,最后确认LSP-pyright是否成功下载服务器二进制
最常被忽略的一点:LSP 的“启用语言”操作必须手动执行一次——命令面板输入 LSP: Enable Language Server Globally 并选中目标语言,状态栏才会显示 LSP-pyright active。不点这一步,前面所有配置都白搭。











