WebStorm为何无法显示二级对象的方法与属性文档？

问题情况 #

用WebStorm的时候，调用对象的二级属性、方法（比如DOM元素的tagName、getAttribute()），IDE完全不显示文档或代码提示，只弹出unresolved method提示。已经试过这些操作但没彻底解决：

• 开启show full method signatures，刚开始有用，后来又失效了
• 将JavaScript语言版本先改成ES 5.1再改回ES 6+
• 确认WebStorm是最新版本

解决步骤 #

1. 清缓存重启 #

IDE缓存异常常导致索引问题，直接清理后重启：

• 点击顶部菜单 File > Invalidate Caches...
• 在弹窗里勾选Clear file system cache and local history，再点击Invalidate and Restart

2. 检查JavaScript库配置 #

如果是DOM相关对象出问题，要确保IDE加载了核心库：

• 打开Settings > Languages & Frameworks > JavaScript > Libraries
• 检查HTML、DOM、ECMAScript这些核心库是否被勾选，未勾选的话启用，点击Apply后重启IDE

3. 添加类型标注（自定义/第三方对象适用） #

如果是自定义对象或第三方库对象识别异常，用JSDoc标注类型帮助IDE识别：

/** @type {HTMLElement} */
const element = document.getElementById('test');
// 此时element的getAttribute等方法就能正常显示文档提示
element.getAttribute('id');

4. 检查项目配置文件 #

• 查看项目根目录的jsconfig.json或tsconfig.json，确保compilerOptions里的target设置为你使用的ES版本，lib字段包含dom这类必要库
• 检查.gitignore或WebStorm专属配置文件，确认没有误排除需要索引的文件

内容的提问来源于stack exchange，提问作者Jonathan