webstorm中@/别名标红但运行正常，需三步解决：①tsconfig.json中设"baseurl":"."和"@/":["src/"]；②settings中启用use paths mapping from tsconfig.json；③右下角ts图标→restart typescript service。
WebStorm怎么让 @/ 别名在编辑器里跳转生效
别名标红但运行正常，Ctrl+Click 无响应，本质是 WebStorm 没把 @/ 映射到 src/ 目录。它不读 webpack.config.js 或 vite.config.ts 里的 resolve.alias，只认 tsconfig.json 的 paths 配置。
必须同时满足三个条件：
-
tsconfig.json中compilerOptions.baseUrl是相对路径（如"./src"，不能是"src"或"/src"） -
paths的 key 必须以/结尾（如"@/*": ["*"]，不能写成"@*"或"@"） - WebStorm 设置中勾选 Use paths mapping from tsconfig.json（路径：Settings → Languages & Frameworks → TypeScript）
改完配置后，点右下角 TS 图标 → Restart TypeScript Service，否则不生效。Vue CLI 或 Vite 项目也得走这条路，没有例外。
为什么手动添加 CDN 库后还是没代码提示
常见现象：粘贴了 https://cdn.jsdelivr.net/npm/vue@2.7.14/dist/vue.min.js，WebStorm 提示“Download library”，点了却没补全、Vue 依然标红。
根本原因不是下载失败，而是库没被“启用”：
- 进入 Settings → Languages & Frameworks → JavaScript → Libraries
- 找到刚添加的库条目，检查右侧是否勾选了 Include library in project（即那个小对勾）
- 没勾选 = IDE 当它不存在；勾了但没提示？重启 WebStorm 再试一次
- 如果用的是
.min.js文件，建议换.js版本——压缩版通常不含 JSDoc，TypeScript 无法推导类型
webpack.config.js 放在 config/ 下，WebStorm 就不识别 alias
WebStorm 默认只扫描项目根目录（package.json 所在层）的 webpack.config.js、webpack.config.cjs、webpack.config.mjs。放在子目录就直接忽略。
两种解法，按优先级排序：
- 把配置文件移到根目录（最省事，避免后续 alias、loader、plugin 全部失灵）
- 进 Settings → Languages & Frameworks → JavaScript → Webpack，手动填路径，例如
config/webpack.config.cjs - 填完必须点右上角 Reload configuration，否则 WebStorm 还是当没这回事
注意：即使配置文件被识别，alias 跳转仍不会自动生效——还得回到 tsconfig.json 配 paths，这是两件事。
移动 src/utils 文件夹后，import { foo } from '@/utils' 报错
这不是路径写错了，而是 WebStorm 的引用更新机制没触发。直接拖拽文件夹到新位置，IDE 不会自动改所有 import 语句里的 @/ 引用。
正确做法只有这一种：
- 在 Project 工具窗口中，右键点击
src/utils文件夹 → Refactor → Move（或按F6） - 目标选
src/lib（或你要去的位置），WebStorm 会批量更新全部import中的@/utils为@/lib - 如果目标目录不存在，它会提示你创建；但不会帮你建多层嵌套（比如
src/shared/utils），父级得提前存在
跨项目复用外部库时，最容易被忽略的是：移动后 tsconfig.json 的 include 是否覆盖新路径。漏了就会导致类型检查静默失效，看着不报错，实际没校验。
