VSCode依赖tsserver解析路径别名，需正确配置tsconfig.json的baseUrl和paths并重启tsserver；运行时如ts-node还需额外注册tsconfig-paths。
VSCode 本身不解析路径别名，它依赖 TypeScript 编译器（tsserver）或运行时工具（如 ts-node）来理解 @/utils 这类导入。配置错一步，VSCode 就会标红、跳转失效、智能提示丢失。
tsconfig.json 的 baseUrl 和 paths 必须配对生效
这是 TypeScript 编译器识别别名的唯一原生方式，VSCode 的类型服务（tsserver）直接读取这个配置。
-
baseUrl是所有paths解析的根目录，必须是相对tsconfig.json的有效路径，常见值为"./"或"src" -
paths中的键必须以/结尾（如"@/*"），否则 VSCode 不会匹配通配规则 - 值数组里每个路径都必须是相对于
baseUrl的，且需存在真实目录，否则跳转失败但无报错 - 示例正确写法：
{ "compilerOptions": { "baseUrl": "./", "paths": { "@/*": ["src/*"], "@api/*": ["src/api/*"] } } }
VSCode 需要重启 tsserver 才能感知 tsconfig 修改
改完 tsconfig.json 后，VSCode 不会自动重载类型服务 —— 这是高频盲区。
- 快捷键
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS） - 输入
Restart TS server并回车 - 观察右下角状态栏是否出现 “TypeScript language service is ready” 提示
- 若仍不生效，检查
tsconfig.json是否在工作区根目录；嵌套子项目需确保打开的是该子项目文件夹，而非整个 monorepo 根
运行时别名（如 ts-node）和编辑器别名不是一回事
你在代码里用 import { foo } from "@/utils" 能被 VSCode 理解，不代表 Node 能运行它 —— 这是两个独立环节。
- VSCode 仅靠
tsconfig.json就能提供跳转和类型提示 - 但
ts-node或node运行时默认不认识@，需额外注册解析器，例如：
安装tsconfig-paths，并在启动命令中加-r tsconfig-paths/register - 常见错误：只配了
tsconfig.json，却用ts-node server.ts直接运行，报错Cannot find module '@/utils' - 正确命令示例：
ts-node -r tsconfig-paths/register server.ts
别名冲突时，VSCode 优先使用最短、最具体的匹配
多个 paths 规则可能同时命中一个导入路径，VSCode（tsserver）按字典序和长度选择，不是按声明顺序。
- 比如同时定义了
"@/*": ["src/*"]和"@components/*": ["src/components/*"] - 当写
import Button from "@/components/Button"，它会走第二条规则，而不是先匹配@/再拼接 - 但若写成
import Button from "@components/Button"（缺结尾/），则两条都不匹配，直接报错 - 验证方式：把鼠标悬停在导入路径上，看 VSCode 底部提示的实际解析路径
真正卡住人的往往不是怎么配，而是改完配置后没重启 tsserver，或者以为编辑器能跑通就等于运行时也能跑通。这两层解耦必须分清。
