
如果您在使用 VSCode 编辑代码时,将鼠标悬停在某个符号上却未显示其定义信息,则可能是由于语言服务器未启用、扩展缺失或相关设置被禁用。以下是恢复“悬停显示定义”功能的多种操作方式:
本文运行环境:MacBook Air,macOS Sequoia。
一、检查并启用 Hover 功能设置
VSCode 默认开启悬停提示,但该功能可能被用户手动关闭。需确认设置项是否处于激活状态。
1、按下 Cmd + , 打开设置界面。
2、在搜索框中输入 editor.hover.enabled。
3、确认右侧开关已启用,即值为 true。
二、验证对应语言扩展是否已安装并激活
“悬停显示定义”依赖于语言服务器协议(LSP)支持,不同编程语言需对应的语言扩展提供 Hover 能力。
1、点击左侧活动栏的扩展图标(四个方块组成的图标)。
2、在搜索框中输入目标语言名称,例如 Python 或 JavaScript and TypeScript。
3、确保官方扩展(如 Microsoft 发布的 Python 或 TypeScript Toolkit)已安装且状态为启用。
三、重启语言服务器
语言服务器可能因缓存异常或初始化失败而无法响应 Hover 请求,强制重启可恢复服务。
1、按下 Cmd + Shift + P 打开命令面板。
2、输入 Developer: Restart Language Server 并回车。
3、等待状态栏右下角出现 Language Server restarted 提示。
四、检查工作区设置是否覆盖全局设置
当前文件夹下的 .vscode/settings.json 可能包含禁用 Hover 的配置,优先级高于全局设置。
1、在资源管理器中展开项目根目录,查看是否存在 .vscode 文件夹。
2、打开其中的 settings.json 文件。
3、查找是否存在键名为 "editor.hover.enabled" 且值为 false 的条目。
4、将其删除或修改为 true。
五、禁用可能干扰的扩展
部分第三方扩展(如代码高亮增强、注释折叠类工具)会劫持编辑器事件,导致 Hover 响应被拦截或延迟。
1、按下 Cmd + Shift + P,输入并选择 Extensions: Show Enabled Extensions。
2、逐个禁用近期安装的非官方扩展,每禁用一个后测试悬停功能是否恢复。
3、若某扩展禁用后功能恢复正常,可将其保留在禁用状态或查阅其文档确认兼容性设置。










