装LSP插件是当前最稳的通用智能补全方案,必须配合对应语言服务器(如LSP-pyright、LSP-typescript)并正确配置路径、项目配置文件(如pyrightconfig.json、tsconfig.json)和客户端启用状态,否则仅显示变量名而无函数签名、类型提示或悬停文档。

Sublime Text 默认没有智能补全能力,装错插件或漏配关键项,补全就只出变量名、不出函数签名或类型提示——这不是编辑器不行,是没走对路。
装 LSP 插件是当前最稳的通用方案
LSP(Language Server Protocol)是现代编辑器智能提示的事实标准,它不靠本地词频匹配,而是调用真实语言服务器做语义分析。相比 SublimeCodeIntel 或旧版 Anaconda,LSP 支持跳转定义、悬停看类型、重命名重构等 IDE 级功能,且各语言配置逻辑统一。
- 必须先装
Package Control:按Ctrl+`打开控制台,粘贴官网安装脚本(注意 2026 年已支持 HTTPS,用https://packagecontrol.io/installation) - 再通过命令面板(
Ctrl+Shift+P)运行Package Control: Install Package,搜LSP安装主插件 - 装完后,必须单独安装对应语言的服务器,比如写 Python 就要装
LSP-pyright,写 TypeScript 就要装LSP-typescript;只装 LSP 主体,不装服务器,补全完全不会触发 - 验证是否生效:打开一个 .py 文件,输入
os.,稍等 1–2 秒,应弹出方法列表;若无反应,打开View → Show Console查看是否有Failed to start server类错误
LSP-typescript 补全失效的三个硬卡点
装了 LSP 和 LSP-typescript 却没提示?90% 是卡在这三处,和插件本身无关:
-
typescript-language-server没全局安装:终端执行npm install -g typescript-language-server(Node ≥ 16),不能只装typescript - 项目根目录缺
tsconfig.json:哪怕空文件也得有,内容可为{"compilerOptions": {}};没有它,服务器启动后立刻退出,LSP 日志里会显示no tsconfig.json found - LSP 设置里没启用
typescript客户端:打开Preferences → Package Settings → LSP → Settings,确认"clients"下有"typescript"块,且"enabled"为true
Python 补全别用 Anaconda,优先选 LSP-pyright
Anaconda 插件在 ST4 上已基本停止维护,其类型推导依赖过时的 Jedi 版本,遇到 from typing import Annotated 或 __future__.annotations 直接失效;而 LSP-pyright 基于微软官方 Pyright,原生支持 PEP 695、类型守卫、泛型推导等新特性。
- 安装
LSP-pyright后,无需额外装 Python 包,Pyright 自带解析引擎 - 若项目用虚拟环境,需在项目根目录放
pyrightconfig.json,指定"include": ["src", "tests"]和"pythonVersion": "3.12",否则补全可能漏模块 - 避免和
SublimeCodeIntel共存:两者都监听.键,会互相干扰,禁用前者更干净
Emmet 会劫持 JS/TS 补全,必须关掉
Emmet 默认把 . 当作缩写触发键,你在 arr. 后想看 map 方法,结果弹出 <div class=""></div>——这是 Emmet 截胡了 LSP 的补全请求。
- 打开
Preferences → Package Settings → Emmet → Settings - 把
"disable_tab_abbreviations_on_snippets"设为true - 再加一行:
"disable_tab_abbreviations_for_scopes": "source.js, source.ts, source.jsx, source.tsx" - 改完不用重启,但已打开的 JS 文件需手动重新加载语法(右下角点 HTML → 选 JavaScript)才能生效
真正难的不是装插件,是让语言服务器跑起来并持续稳定输出语义信息;多数“没提示”问题,其实日志里早写了原因,只是没人去看 View → Show Console 里那几行红色报错。


















