sublime text 默认不支持悬停定义预览，需通过 sublimelsp 插件配合对应语言服务器（如 pylsp）并正确配置项目识别文件、路径及初始化选项方可启用。
Sublime Text 默认不支持悬停定义预览
它没有像 VS Code 那样的原生 hover 功能，点一下就弹出类型或文档——这个得靠插件补足，而且不是装上就自动生效，得配语言服务或符号索引机制。
常见错误现象：Ctrl+Click 能跳转但悬停没反应；装了 SublimeLSP 却没看到提示；用 CTags 生成了标签文件，悬停仍空白。
- Sublime 本身只提供基础语法高亮和简单跳转，
hover是 LSP（Language Server Protocol）或插件自建索引的能力 - 轻量级方案里，
SublimeLSP+ 对应语言服务器（如pylsp、typescript-language-server）是目前最稳的路径 - 别指望
CTags插件（如CTags或SublimeCodeIntel）能提供结构化悬停内容——它们只返回符号位置，不带类型/文档
启用悬停需满足三个硬条件
缺一不可：LSP 插件安装、语言服务器可执行、项目配置正确。少一个，hover 就是灰色状态。
-
SublimeLSP必须通过 Package Control 安装（不是手动放插件目录），且版本 ≥ v1.20.0（旧版 hover 支持不完整） - 对应语言服务器要能被 Sublime 找到：要么加进系统
PATH，要么在LSP.sublime-settings里用"command"指定绝对路径，比如["/usr/local/bin/pylsp"] - 项目根目录要有识别依据：Python 项目需有
pyproject.toml或setup.py；JS/TS 项目需有package.json或tsconfig.json，否则 LSP 不启动
示例（Python）：
{
"clients": {
"pylsp": {
"command": ["/opt/homebrew/bin/pylsp"],
"enabled": true,
"initializationOptions": {
"plugins": {
"jedi_completion": {"enabled": true},
"jedi_definition": {"enabled": true},
"jedi_hover": {"enabled": true}
}
}
}
}
}
悬停失效时优先检查这三处
90% 的“悬停没反应”问题出在这儿，而不是插件没装对。
- 看右下角状态栏：有没有显示
LSP-pylsp或类似字样？没显示说明服务器根本没连上，先查终端里手动运行pylsp --version是否报错 - 打开命令面板（
Ctrl+Shift+P），搜LSP: Show Log，重点看有没有Failed to start或connection refused - 悬停光标必须落在**已解析符号上**：比如
requests.get，悬停get有效，悬停.或空格无效；自定义类方法若没被 import，LSP 也识别不了
性能与兼容性实际表现
悬停响应快慢，取决于语言服务器本身，不是 Sublime 的锅。Python 用 pylsp 基本秒出，TS 用 typescript-language-server 在大项目里可能卡 300–500ms。
- macOS 上推荐用
brew install python-lsp-server，避免 pip 安装后依赖冲突导致 hover 失效 - Windows 用户注意：PowerShell 默认策略常拦截
pylsp启动，建议改用 CMD 或临时设Set-ExecutionPolicy RemoteSigned -Scope CurrentUser - 如果只是想看函数签名（不看文档），可以关掉
jedi_hover，只留jedi_signature_help，响应会更快一点
真正麻烦的是跨文件类型推导——比如从 utils.py 导入的函数，在 main.py 悬停时，如果没开 "auto_import_modules" 或没配 "python.analysis.extraPaths"，hover 就是空的。这点很容易被忽略，但恰恰是多数人卡住的地方。
