WebStorm 默认大小写敏感导致路径跳转失败，需统一改为小写目录名并配置tsconfig.json的paths映射，重启TypeScript服务生效。
WebStorm 默认不匹配大小写不同的路径，是因为它把 src/utils 和 Src/Utils 当成两个完全无关的路径——这不是 bug，是设计如此。要让它识别大小写不敏感的路径跳转（比如点击 @/utils 跳到 Src/Utils），必须手动打通 TypeScript 路径映射 + Webpack alias + IDE 解析三者之间的断层。
为什么 Ctrl+Click 会跳转失败
常见现象：代码里写 import { foo } from '@/utils/helper';，但按住 Ctrl 点击 @/utils/helper 没反应，或跳到错误文件；终端能跑通，IDE 却标红。根本原因不是路径写错了，而是 WebStorm 没法把字符串路径 @/utils/helper 和磁盘上真实路径 Src/Utils/Helper.ts 对上号。
- Webpack 的
resolve.alias是运行时生效的，WebStorm 不执行 JS，只做静态分析 - WebStorm 默认只信任
tsconfig.json中的paths配置，且要求大小写严格一致 - 即使你写了
"@/*": ["src/*"]，但实际目录名是Src，它就不会匹配 - Windows/macOS 文件系统默认大小写不敏感，但 WebStorm 的索引和解析逻辑仍是大小写敏感的
让 WebStorm 接受大小写不敏感路径的实操步骤
核心思路：不改系统行为，而是让所有路径定义统一为小写，并在 IDE 层强制对齐。这不是妥协，而是最稳定的做法。
- 把项目中所有涉及别名的目录重命名为全小写，例如把
Src改成src、Components改成components——这是最省事、副作用最小的方式 - 确保
tsconfig.json的baseUrl和paths使用小写路径：{"baseUrl": "./src", "paths": {"@/*": ["src/*"]}} - 在 WebStorm 设置中启用 TypeScript 路径映射支持：Settings → Languages & Frameworks → TypeScript → 勾选
Use paths mapping from tsconfig.json - 修改完后点击右下角 TypeScript 图标 →
Restart TypeScript Service，否则新配置不加载 - 如果已存在大小写混用的历史路径，删掉
.idea目录并重启 WebStorm，避免旧索引干扰
别试图用 Ignored Files or Excluded 绕过这个问题
有人想通过把 Src 加进 Ignored Files and Folders，再把 src 加进项目来“欺骗”IDE，这行不通。
-
Ignored Files and Folders只控制是否建索引，不影响路径解析逻辑 - Excluded 目录里的文件仍可能被引用路径命中，但跳转会失败或指向空文件
- 符号链接（如 pnpm link 创建的）会绕过所有忽略规则，导致更混乱的路径解析结果
- WebStorm 不支持通配符路径匹配（如
@/**），也不支持正则式 alias 映射
真正难的不是配置本身，而是接受一个事实：WebStorm 的路径解析能力，永远追不上你本地文件系统的宽容度。它需要明确、稳定、可推导的路径规则，而不是靠猜。所以与其折腾大小写兼容，不如从第一天就约定全小写——这比任何设置都管用。
