WebStorm中@/xxx标红但运行正常，是因为TypeScript服务未加载tsconfig.json的paths映射：必须设"baseUrl": "."、正确配置"@/": ["src/"]、安装@types/node、启用路径映射并手动重启TS服务。
WebStorm 里 @/xxx 标红但运行正常，说明 TypeScript 服务根本没加载你的路径映射
这不是 WebStorm “不支持”，而是它默认忽略 tsconfig.json 中的 paths，除非你手动告诉它“请按这个配置解析模块”。运行时（Vite/Webpack）和编辑器走的是两套系统：构建工具读 vite.config.ts 或 vue.config.js 里的 resolve.alias，而 WebStorm 只认 tsconfig.json（或 jsconfig.json）中静态声明的 baseUrl 和 paths。
常见错误现象包括：Cannot find module '@/utils'、Ctrl+Click 跳转失败、输入 @/ 后无补全。这些全是 TypeScript 语言服务未生效的典型信号。
- 先确认右下角状态栏有 TypeScript 小图标；没有，说明 TS 服务压根没启动
- 检查项目是否真在用本地
typescript（不是 WebStorm 内置版本）：Settings → Languages & Frameworks → TypeScript → TypeScript version 必须指向node_modules/typescript -
tsconfig.json必须存在且被正确识别——如果项目用了tsconfig.app.json（如 Vue CLI 默认），TypeScript 会优先用它，此时paths得写进tsconfig.app.json，而不是根目录的tsconfig.json
baseUrl 写成 "./src" 或 "src" 是最常踩的坑
TypeScript 规范要求 baseUrl 必须是绝对路径或 "."，不支持相对路径字面量。写成 "./src" 看似合理，但 TypeScript 会直接忽略整个 paths 配置，WebStorm 也就“看不见”别名。
正确写法只有一种逻辑：所有 paths 的解析起点，必须是 tsconfig.json 所在目录本身（即 "."），然后靠 paths 值去拼接真实路径。
- ✅ 正确：
"baseUrl": "."+"@/*": ["src/*"] - ❌ 错误：
"baseUrl": "./src"、"baseUrl": "src"、"baseUrl": "/Users/you/project/src" -
paths的 key 必须以/结尾："@/*"✅，"@"❌（否则通配不触发） - 确保
src/目录真实存在，且大小写与路径完全一致（Linux/macOS 区分大小写）
为什么装了 @types/node 是硬性前提？
不装 @types/node，TypeScript 会报一堆 path.resolve is not defined 类型错误，进而导致整个 tsconfig.json 被 WebStorm 视为“无效配置”，连带 paths 也被跳过。
这不是可选项，是 TypeScript 类型检查链的底层依赖。哪怕你不用 Node API，只要 tsconfig.json 里写了 baseUrl，TS 就会尝试校验环境上下文。
- 执行：
npm install @types/node --save-dev - 安装后重启 WebStorm 或至少重启 TypeScript 服务（右下角 TS 图标 → Restart TypeScript Service）
- 如果用的是
jsconfig.json（纯 JS 项目），同样要装@types/node，否则baseUrl依然失效
改完配置后不重启 TypeScript 服务，等于白配
WebStorm 不会自动监听 tsconfig.json 变更并重载路径映射。你改完 baseUrl 和 paths，勾选了 Use paths mapping from tsconfig.json，但如果不点那个重启按钮，编辑器继续用旧缓存——跳转还是错的，补全还是没有。
重启操作必须手动触发，且每次修改 tsconfig.json 后都要做一次。
- 方式一：右下角 TypeScript 图标 → Restart TypeScript Service
- 方式二：快捷键
Ctrl+Shift+A（macOS 是Cmd+Shift+A），搜 “Restart TypeScript Service” 并执行 - 如果重启后仍无效，试试 File → Invalidate Caches and Restart → Just Restart（缓存污染很常见）
最易被忽略的点是：你以为配的是 tsconfig.json，但实际生效的是 tsconfig.app.json 或 jsconfig.json；你以为 baseUrl 指向 src 就行，但 TypeScript 只认 "."；你以为装了 Vite 别名就万事大吉，但 WebStorm 根本不读 vite.config.ts 里的 resolve.alias。
