根本原因是webstorm默认按commonjs推导模块，而项目使用esmodule但未明确告知；需检查package.json是否含"type": "module"，或手动设置javascript版本为es6+并重载项目。
WebStorm 识别不了 import 或标红 Unresolved variable
根本原因不是 WebStorm 不支持 ESModule，而是它默认按 CommonJS（require）推导模块上下文。当你在 .js 文件里写 import，但项目没明确声明模块类型，WebStorm 就不会解析这些语句，自然跳转失效、补全不触发、变量报红。
- 检查项目根目录
package.json是否含"type": "module"—— 这是 Node.js 和 WebStorm 共同认可的开关，有它就自动切 ESM 模式 - 没有
"type": "module"？那.js文件默认仍被当 CommonJS 处理；临时解法是右键单个文件 → Override File Type → 选JavaScript (ES6)，但只对当前文件生效，不解决跨文件引用 - 若用
.mjs后缀，WebStorm 会无条件按 ESM 解析，但需确保构建工具（如 Vite/Webpack）也支持该后缀，否则运行时报错
Alt+Enter 不弹出导入建议或自动导入失效
自动导入不是开个开关就行，它依赖三重条件同时满足：语言版本正确、模块语法合规、Auto Import 开关全启用。
- 进 Settings → Languages & Frameworks → JavaScript，Language version 必须设为
ECMAScript 6+（不能是 ES5） - 进 Settings → Editor → General → Auto Import，三个选项都要勾上：
Add ES6 imports on code completion、Show auto-imports tooltip、Optimize imports on the fly - 导出必须用
export（不是module.exports），且不能被declare module或未声明全局污染遮蔽；React 组件推荐用具名导出（export const Button = ...），比export default React.memo(...)更稳定
import 路径没带 .js 后缀，Chrome 报错 Module not found
浏览器 ESM 加载强制要求路径含扩展名，但 WebStorm 默认生成的 import { foo } from '@/utils' 不带后缀，本地开发正常，部署到静态服务器就 404。
- 进 Settings → Editor → Code Style → JavaScript → Imports，勾选
Use file extension in imports - 该设置只影响新生成的 import；已有语句需手动优化：选中文件 →
Ctrl+Alt+O（Windows/Linux）或Cmd+Alt+O（macOS） - 注意：若项目用了别名（如
@/），WebStorm 不读jsconfig.json的compilerOptions.paths，需在 Settings → Languages & Frameworks → JavaScript → Libraries → Add 手动添加映射路径
第三方包导入不提示、跳不到源码
WebStorm 对 node_modules 的索引依赖类型定义和源码下载，纯 JS 库（如早期 lodash、axios）若没附带 .d.ts，它就无法推断导出成员，Alt+Enter 只能手动选路径，无法“无感导入”。
- 在 Settings → Languages & Frameworks → JavaScript → Libraries 中，确认已添加
node_modules并勾选Download sources - 若有
jsconfig.json或tsconfig.json，确保含"moduleResolution": "node"和"module": "ESNext"，否则 WebStorm 无法匹配 Node.js 的模块解析逻辑 - 遇到
exports字段（如"exports": { ".": "./dist/index.js" }）时，仅 WebStorm 2022.3+ 支持跳转；老版本直接忽略，建议升级或改用main/module字段
package.json 的，它不执行代码、不读构建配置、也不模拟运行时行为。哪怕 Vite 配了 resolve.alias，WebStorm 依然认不到 @/components 指向哪——这得靠手动加路径映射，不是靠“重启 IDE”就能解决的。Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
