editor.hover.delay是唯一生效的延迟配置项,单位毫秒,默认500;设200~400最平衡响应与稳定性,设0会暴露语言服务冷启动抖动致闪屏或卡顿,修改后需悬停新代码行才生效。

editor.hover.delay 是唯一生效的延迟配置项
VSCode 悬浮提示的弹出延迟只由 editor.hover.delay 控制,单位毫秒,默认值是 500。它不是“鼠标停住多久就显示”,而是决定 VSCode 何时向语言服务器发起请求——设太小会暴露服务冷启动抖动,设太大又显得迟钝。
- 设为
200~400是多数人手感最稳的区间:比默认快,又避开 TypeScript 初始化、Volar 解析<script setup></script>等典型卡顿点 - 设为
0不等于“立刻显示”,而是跳过等待、立刻发请求——结果常是空白框闪一下,或卡住 2~3 秒(此时你在看typescript.tsserver.log的 “Loading…”) - 改完不用重启 VSCode,但旧悬停提示可能还缓存着;需悬停到新代码行才生效
为什么改了 editor.hover.delay 却没反应
大概率不是配置写错,而是被更高优先级设置覆盖,或 hover 功能本身被关掉了。
- 检查
editor.hover.enabled是否为true——如果它是false,再小的 delay 也没用 - 打开命令面板(
Ctrl+Shift+P),运行Developer: Toggle Developer Tools,切到 Console 标签页,悬停时看有没有报错,比如HoverProvider not found - 临时禁用 ESLint、Tailwind CSS IntelliSense、IntelliCode 这类扩展,它们可能劫持或阻塞 hover 提供链
- 确认你改的是当前工作区的
.vscode/settings.json,而不是用户全局设置——工作区设置优先级更高
不同语言扩展不共享 editor.hover.delay
Pylance、Volar、Rust Analyzer 这类语言扩展通常忽略 editor.hover.delay,用自己的策略控制触发时机。表现就是:你在 JS 文件里把 delay 调到 100,悬停 Python 文件还是慢半拍。
- Volar v1.10+ 支持专属配置
volar.hover.delay - Rust Analyzer 的 hover 行为受
rust-analyzer.hoverActions.enable影响,但它不控制延迟;目前未暴露delay配置项 - 找不到专属配置时,更有效的是减小语言服务器负担:在
settings.json中加"files.watcherExclude": { "node_modules/**": true, "dist/**": true }
想彻底禁用自动悬停但保留手动唤出能力
直接设 "editor.hover.enabled": false 就行。它只禁自动弹出,不影响快捷键调用。
- 手动唤出命令是
editor.action.showHover,默认绑定为Ctrl+K Ctrl+I(Windows/Linux)或Cmd+K Cmd+I(macOS) - 这个组合键绕过所有 delay 和 enabled 判断,强制拉取当前光标处信息,并以居中模态方式悬浮,可滚动、不随鼠标移动
- 若系统或输入法(如搜狗拼音、Raycast)拦截了该组合键,先退出它们再试——比重配十次更有效
真正难的不是调那个数字,而是判断当前延迟到底是配置问题,还是语言服务器正在加载、插件正在抢资源、或者你的显示器缩放让坐标映射错乱。先看状态栏右下角有没有 “TypeScript initializing…”,再开 DevTools 看 Console,最后才动设置。











