直接修改 editorHoverWidget.background 颜色需在 workbench.colorCustomizations 中配置，例如 "editorHoverWidget.background": "#2a2d34"，并建议同步设置 editorHoverWidget.border 和 editorHoverWidget.foreground 以确保边框可见、文字清晰；该配置纯 JSON 生效，无需重启，但须避免语法错误或被主题插件覆盖。
怎么改 editorHoverWidget.background 颜色？
直接改这个颜色令牌就能控制悬停提示（比如鼠标停在函数上弹出的文档框）的背景。它不依赖主题插件，也不需要额外扩展，纯 JSON 配置生效。
打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），输入并选择 Preferences: Open Settings (JSON)，在 "workbench.colorCustomizations" 里加这一项：
{
"workbench.colorCustomizations": {
"editorHoverWidget.background": "#2a2d34",
"editorHoverWidget.border": "#4a5b6e"
}
}
- 值必须是合法 CSS 颜色：十六进制（如
#2a2d34）、RGB（如rgb(42, 45, 52)）或命名色（如slategray） - 如果没写
editorHoverWidget.border，悬停框可能没边框、看起来“粘”在代码上，建议一并配 - 改完保存即可，不用重启 VS Code，但需确保当前没有语法错误导致整个 JSON 解析失败
为什么改了没反应？常见失效原因
悬停背景色不生效，大概率不是配置错，而是被其他设置覆盖或上下文条件限制住了。
- 检查是否用了带方括号的主题限定写法，比如
"[Monokai]": { "editorHoverWidget.background": "#..." }—— 这种只在激活Monokai主题时才生效，换主题就回退 -
editorHoverWidget是工作台级颜色令牌，不能放在editor.tokenColorCustomizations里（那是管语法高亮的） - 某些主题插件（如
Nord、Dracula）会强行重载所有 hover 样式，此时需确认插件文档是否禁用了自定义覆盖 - 如果同时设置了
workbench.colorCustomizations和editor.tokenColorCustomizations，且 JSON 格式有逗号缺失或引号不闭合，VS Code 会静默忽略整块配置
和 editorSuggestWidget 背景色有什么区别？
别混淆这两个：一个是悬停（hover），一个是智能提示下拉列表（suggest）。它们用的是不同令牌，样式也完全独立。
-
editorHoverWidget.background：鼠标悬停函数/变量时弹出的文档框 -
editorSuggestWidget.background：按Ctrl+Space或输入时出现的补全列表背景 -
editorSuggestWidget.border和editorSuggestWidget.highlightForeground也常一起调，否则选中项看不清 - 两者可以设成同色系，但不要共用同一个键名——VS Code 不认
editorHoverWidget去管补全框
深色模式下悬停文字看不清怎么办？
只改背景色不够，文字颜色由 editorHoverWidget.foreground 控制，它默认继承当前主题的文本色，但在深底上可能太浅或太灰。
- 加上这行：
"editorHoverWidget.foreground": "#e0e0e0"，确保文字足够清晰 - 如果悬停里含链接（比如 TypeScript 的
@see），还要配"editorHoverWidget.link.foreground": "#4dabf7" - 注意：VS Code 1.94+ 开始对
link.foreground支持更稳定，旧版本可能忽略该字段 - 测试方法：在 TS/JS 文件里写个带 JSDoc 的函数，把鼠标停上去，看文档里的文字和链接是否可读
editorHoverWidget 系列颜色时，最容易漏掉的是 border 和 foreground 的联动；只调背景，结果框变色了但文字糊成一片，或者边框消失导致悬浮框“融”进编辑器里——这种细节不试真不知道。 
