WebStorm中@/标红但运行正常，是因为TypeScript服务未加载tsconfig.json的paths配置：需确保baseUrl为"."、paths格式正确、启用路径映射并重启TS服务，且安装@types/node。
WebStorm里@/xxx标红但运行正常，说明TS服务没加载paths
这不是 WebStorm “不支持别名”，而是 TypeScript 语言服务压根没读你的 tsconfig.json 中的 paths 配置。构建工具（Vite/Webpack）能跑通，是因为它走的是 vite.config.ts 或 webpack.config.js 里的 resolve.alias；而 WebStorm 只认 tsconfig.json（或 jsconfig.json）中静态声明的 baseUrl 和 paths，且必须手动启用+重启服务。
- 右下角状态栏没有 TypeScript 小图标 → TS 服务未启动，
paths直接被忽略 - 项目用了
tsconfig.app.json（如 Vue CLI、某些 Vite 模板），TypeScript 会优先用它 —— 此时paths必须写进tsconfig.app.json，不是根目录的tsconfig.json -
baseUrl写成"./src"或"src"是最常见错误：TypeScript 规范只接受"."或绝对路径，相对路径字面量会被整个paths配置跳过
tsconfig.json 的 baseUrl 和 paths 必须严格合规
哪怕只错一个字符，WebStorm 就当配置不存在。正确写法只有一种逻辑：baseUrl 指向 tsconfig.json 所在目录（即 "."），所有 paths 值都基于此拼接真实路径。
- ✅ 正确：
"baseUrl": "."+"@/*": ["src/*"] - ❌ 错误：
"baseUrl": "./src"、"baseUrl": "src"、"@": ["src"]（key 缺少/，通配不触发） - 路径大小写必须完全一致：macOS/Linux 区分大小写，
src/Utils和paths里写的"src/utils/*"会导致跳转失败 - 如果项目是 JS 项目（无 TS），可用
jsconfig.json替代，结构相同，但 WebStorm 仍需识别为 JS 项目并启用路径映射
WebStorm 设置里必须勾选并重启 TS 服务
即使 tsconfig.json 完全正确，WebStorm 默认也可能不启用路径映射。这个开关藏得深，且改完不重启 = 白配。
- 进入
Settings → Languages & Frameworks → TypeScript - 确认
TypeScript version指向node_modules/typescript（不是 WebStorm 内置版本） - 勾选
Use paths mapping from tsconfig.json（新版默认开，旧版或重装后常被关） - 点击
Apply后，**必须手动重启 TS 服务**：右下角 TS 图标 →Restart TypeScript Service（快捷键Ctrl+Shift+A搜 “Restart TypeScript Service”）
@types/node 是硬性依赖，不是可选项
不装 @types/node，TypeScript 会报一堆 path.resolve is not defined 类型错误，进而判定整个 tsconfig.json 无效 —— 连带 baseUrl 和 paths 全部被跳过，WebStorm 直接“看不见”别名。
- 执行：
npm install @types/node --save-dev（或yarn add @types/node -D） - 装完后务必重启 TS 服务，否则新类型定义不会生效
- 该包还影响路径补全和 Ctrl+Click 跳转的稳定性，尤其在涉及
__dirname、require.resolve等 Node API 的场景
真正卡住人的地方往往不在配置本身，而在三件事没同步：tsconfig.json 写对了、WebStorm 设置打开了、TS 服务重启了。漏掉任意一环，@/ 就永远标红、跳转失效、补全消失 —— 它不是“半生效”，而是“根本不认”。
