需手动开启Show quick documentation on mouse move（路径：Settings → Editor → General → Other），并调延迟至300–400ms；补全高亮需勾选Highlight the most relevant completion suggestions；按键提示须启用Presentation Assistant主开关，非子选项。
WebStorm 的界面提示信息（比如悬停文档、补全高亮、按键反馈）不是开箱即用的，多数需要手动开启对应开关，否则你写对了 JSDoc、按对了 Ctrl+B，也看不到任何反馈——不是插件问题，也不是代码问题，就是功能根本没启用。
怎么让鼠标悬停显示函数或标签的文档
默认关闭，必须手动打开 Show quick documentation on mouse move 才能触发。路径是：Settings → Editor → General → Other，勾选该项，并把下方延迟调到 300–400ms（默认 500ms 容易觉得“卡一下才出来”）。
- 这个设置对
HTML标签（如<div>）、CSS属性（如flex-wrap）、JS函数、JSDoc注释都生效 - 但只在真实语法节点上触发：悬停在
const tag = "div"这种字符串里，不会弹出任何内容 - 如果悬停后只显示
Loading…或空白，优先检查：Stub路径是否指向过时版本；JSDoc是否为严格格式（必须是/** */，/* */或/***/不识别）；最后执行File → Invalidate Caches and Restart → Just Restart
为什么补全弹窗里最相关的项不突出显示
WebStorm 默认不加粗/高亮推荐度最高的补全项，需单独启用。路径是：Settings → Editor → General → Code Completion，勾选 Highlight the most relevant completion suggestions（原名“若存在则标记补全弹窗中最相关的条目”）。
- 启用后，IDE 会基于上下文（类型推导、历史使用频率、导入路径等）自动加粗最可能匹配的项，比如输入
arr.后，map或filter更可能被高亮 - 该选项和
Autopopup code completion是解耦的：即使关掉自动弹出，手动按Ctrl+Space后，高亮依然有效 - 注意别和
Sort suggestions by relevance混淆——后者只调顺序，不改变视觉权重
按键提示（快捷键气泡）为什么按了没反应
必须启用 Presentation Assistant，且不能只开子选项。正确路径：Settings → Appearance & Behavior → System Settings → Presentation Assistant，勾选 Enable Presentation Assistant。
- 常见误操作：只开了
Show shortcuts in popup（这是在搜索面板里显示小图标），不是实时按键反馈 - Mac 用户若按
Cmd键无提示，先确认系统键盘布局是英文；Windows/Linux 若无反应，检查是否被游戏模式、键盘驱动或安全软件拦截了热键 - 提示闪太快？在同一页调高
Popup delay (ms)，建议设为800–1200 - 按了
Ctrl+Alt+L没反应也没提示？用Ctrl+Shift+A打开Find Action，搜Reformat Code，看右侧绑定的快捷键是不是被插件覆盖了
补全弹窗太小、文字挤、关键信息看不清
WebStorm 补全弹窗高度不可直接拖拽调节，它由「最大行数」+「字体大小」+「行间距」共同决定，而最大行数（默认 8）是硬编码限制，无法修改。
- 最有效办法：增大编辑器字体（
Settings → Editor → Font → Size），比如从13改成15，整个弹窗文字立刻变清晰，且仍保持8行可见 - 慎用「减小行高」：需进
Settings → Editor → Color Scheme → Font，勾选Use custom font并调低Line spacing（如0.9），但这会影响所有文本渲染，可能导致注释或控制台文字发虚 - 深色主题（如
Darcula）下，检查Color Scheme → General → Popup的背景/文字对比度，低对比会让小字号内容“糊成一片” - 真正影响体验的常是弹窗位置：它默认出现在光标正下方，容易被底部
Terminal或Run窗口遮挡——按Ctrl+Space手动唤出更可靠
最容易被忽略的是：这些提示功能彼此独立，比如开了 Presentation Assistant 并不意味着 Show quick documentation on mouse move 就自动生效；改了编辑器字体也不代表补全弹窗的行高会同步缩放。每个开关都要单独确认状态，尤其在重装 IDE 或迁移配置后。
