atom-ide-ui是悬停提示的必需底层框架，所有函数签名、类型和文档弹窗均依赖它；未启用或状态异常时，ide-python、ide-java等插件无法输送悬停内容，右下角显示Language Server图标才表示通道连通。
atom-ide-ui 是悬停提示的必需底层
Atom 本身不提供代码悬停（hover）能力，所有函数签名、类型、文档弹窗都依赖 atom-ide-ui。它不是可选插件，而是整个 IDE 功能栈的通信中枢——没有它，ide-python、ide-java、ide-typescript 都无法向编辑器输送悬停内容。
安装后必须重启 Atom，且需确认其状态为 Enabled（蓝色开关），否则即使装了语言插件，悬停也完全不触发。
-
atom-ide-ui会自动拉取并管理对应语言的 Language Server，比如装ide-python后，它会尝试启动python-language-server - 右下角状态栏出现「Python Language Server」或「Java Language Server」图标，才表示悬停通道已连通；显示 disconnected 说明服务未启动或路径错误
- Windows 用户常因 PATH 中无
python命令导致 server 启动失败，建议在ide-python设置里手动填入完整路径（如C:\Python39\python.exe）
悬停不显示？先查 grammar 和 language 插件状态
悬停只在正确语法 scope 下激活。右下角状态栏显示的不是 source.python 或 source.java，而是 Plain Text 或 Python (Jedi)，说明当前文件未被识别为有效源码——悬停直接失效。
- 点击右下角文字 → 选择
Python（不是Python (Jedi)或Python (VirtualEnv)） -
language-python必须启用；若已禁用，ide-python的悬停逻辑不会挂载 - Java 项目需确保
language-java和atom-ide-ui同时启用，且项目根目录含.project或pom.xml（否则 LSP 不加载 classpath）
悬停延迟高或卡死？关掉模糊匹配和文件监听
默认开启的 fuzzy search 和 file-watcher 会让悬停响应变慢，尤其在大项目中。这不是 bug，是设计取舍——Atom 把符号查找和 AST 构建放在主线程，没做异步隔离。
- 在
autocomplete-plus设置中关闭Enable fuzzy searching，能减少悬停前的符号扫描耗时 -
ide-python设置里把Watch files for changes设为 false，避免每次保存都重建 AST - Java 用户可在
atom-ide-ui→Settings中调低Maximum number of diagnostics（默认 1000），防止诊断数据挤占悬停响应带宽
悬停内容为空或只有文件路径？LSP 返回了空响应
这通常不是 Atom 配置问题，而是 Language Server 本身没返回有效 hover 结果。比如 python-language-server 在找不到 symbol 定义时，会返回空对象而非报错，Atom 就渲染为空气。
- 打开开发者工具（
View → Developer → Toggle Developer Tools），切换到 Console 标签页，悬停时观察是否有hover request failed或undefined类错误 - 检查项目是否在虚拟环境内：若
python-language-server启动时没加载 site-packages，第三方库的 docstring 就不可见 - TypeScript 用户注意：
ide-typescript默认不启用 JSDoc 解析，需在设置中勾选Enable JS Doc tooltips
悬停功能的稳定性高度依赖 Language Server 实现质量，而不是 Atom 界面配置。调试时优先看服务进程日志，而不是反复调编辑器设置。
