Sublime如何启用鼠标悬停显示符号定义？（轻量级预览）

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 就是空的。这点很容易被忽略，但恰恰是多数人卡住的地方。