WebStorm 2023.3 通过读取项目根目录的 tsconfig.json 文件自动识别 TypeScript 路径别名，无需在 IDE 设置中单独配置映射规则。适用场景为基于 TypeScript 的前端或 Node.js 项目，风险边界在于若 tsconfig.json 未被 IDE 正确标记或 TypeScript 服务未刷新，别名跳转可能失效。
先说结论：WebStorm 2023.3 依赖 tsconfig.json 中的 compilerOptions.paths 配置解析别名，IDE 本身不提供独立的别名映射界面。
- 适合：使用 TypeScript 且已通过 tsconfig.json 管理路径映射的项目。
- 先准备：确认 tsconfig.json 文件存在且包含正确的 baseUrl 和 paths 字段。
- 验收：在代码中使用别名导入模块，检查 IDE 是否能正确跳转定义且无红色波浪线报错。
快速处理思路
配置 TypeScript 路径别名不需要执行 shell 命令，主要通过编辑配置文件和刷新 IDE 服务完成。
1. 打开项目根目录下的 tsconfig.json 文件。
2. 在 compilerOptions 中配置 baseUrl 和 paths。
3. 在 WebStorm 底部状态栏点击 TypeScript 版本图标，选择 Restart TS Service。
为什么会这样
WebStorm 内置的 TypeScript 语言服务直接遵循 TypeScript 官方编译器规范，不维护独立的别名映射表。
IDE 将 tsconfig.json 视为权威配置源，所有路径解析逻辑均由 TypeScript 语言服务处理。如果 tsconfig.json 配置正确但 IDE 未识别，通常是因为文件未被标记为 TypeScript 配置文件，或者语言服务缓存未更新。这种机制保证了 IDE 行为与 tsc 编译行为一致，避免开发环境与生产环境解析规则不一致。
分步处理
步骤 1：检查 tsconfig.json 配置
打开项目根目录的 tsconfig.json，确认 compilerOptions 中包含 baseUrl 和 paths。适用场景为所有 TypeScript 项目。操作动作是编辑 JSON 文件。风险边界是 paths 中的通配符格式必须正确，例如 "@/*": ["src/*"]。
{\n "compilerOptions": {\n "baseUrl": ".",\n "paths": {\n "@/*": ["src/*"]\n }\n }\n}步骤 2：确认文件标记状态
在 WebStorm 项目视图中，右键点击 tsconfig.json 文件。操作动作是选择 Mark Directory as 或检查文件图标。验证结果是文件图标应显示 TypeScript 配置标识。若未识别，进入 Settings > Languages & Frameworks > TypeScript，确认 tsconfig.json 路径被包含。
步骤 3：重启 TypeScript 服务
修改配置后，IDE 可能不会立即生效。操作动作是点击 WebStorm 底部状态栏右侧的 TypeScript 版本号。选择 Restart TS Service。风险边界是重启期间代码检查可能暂时不可用，需等待几秒。
怎么验证是否生效
验证方法分为代码跳转检查和编译检查两部分。
1. 代码跳转：在任意 .ts 文件中输入 import { Something } from '@/utils/helper'。按住 Ctrl 点击路径字符串。验证结果是光标能准确跳转到 src/utils/helper.ts 文件。
2. 错误检查：观察编辑器行号右侧。验证结果是没有关于模块找不到红色波浪线报错。
3. 终端编译：在 WebStorm 终端运行 tsc `--noEmit`。验证结果是命令行不输出 TS2307 找不到模块错误。
常见坑
1. baseUrl 缺失：paths 配置依赖 baseUrl 生效，若缺少 baseUrl，别名解析会失败。适用场景为新建项目迁移。
2. 多 tsconfig 冲突： monorepo 项目中可能存在多个 tsconfig.json。风险边界是 WebStorm 默认只读取根目录或手动指定的配置文件，需在设置中明确指定使用的配置文件。
3. 缓存未清除：修改配置后未重启 TS 服务。操作动作是强制重启服务，不要仅依赖自动刷新。
常见问题
WebStorm 里有单独设置别名的菜单吗？
没有，WebStorm 不提供独立于 tsconfig.json 的别名设置界面。
配置后代码能跳转但运行报错怎么办？
这是运行时环境问题，WebStorm 只负责编辑时解析，运行时需要构建工具如 Webpack 或 Vite 同步配置别名。
如何切换项目使用的 TypeScript 版本？
进入 Settings > Languages & Frameworks > TypeScript，在 TypeScript 下拉框中选择项目本地版本或 IDE 内置版本。
参考来源
- JetBrains WebStorm 官方文档，Configuring TypeScript，https://www.jetbrains.com/help/webstorm/typescript.html
- Microsoft TypeScript 官方文档，Module Resolution，https://www.typescriptlang.org/docs/handbook/module-resolution.html