path-alias 插件需在 settings.json 中配置 pathalias.aliasmap，如 "@": "${cwd}/src" 才生效；它不读取 tsconfig.json 或构建配置，且严格区分大小写、不支持通配符或相对路径，配置错误或工作区根目录不对是跳转失败主因。
Path-Alias 插件本身不读取 tsconfig.json 或 vite.config.ts，它只认自己专属的配置项；如果别名不识别，90% 是因为插件配置和项目路径没对齐，而不是构建工具配错了。
Path-Alias 的 pathAlias.aliasMap 怎么写才生效
这个插件完全绕过 TypeScript 配置，靠 settings.json 里的 pathAlias.aliasMap 显式声明映射关系。它不解析通配符，也不自动补 /*，必须手写完整对应：
-
"@": "${cwd}/src"—— 正确，${cwd}指向 VSCode 当前打开的工作区根目录 -
"@/": "${cwd}/src/"—— 错误，插件不支持末尾带斜杠的 key，会匹配失败 -
"@": "./src"—— 错误，./在这里不被解析，必须用绝对路径或${cwd} -
"@": "src"—— 错误，相对路径在插件里无效，它不基于baseUrl解析
配置位置：打开 Ctrl+Shift+P → Preferences: Open User Settings (JSON) 或工作区 .vscode/settings.json，添加：
{
"pathAlias.aliasMap": {
"@": "${cwd}/src",
"#utils": "${cwd}/src/utils"
}
}
为什么 Ctrl+Click 还是跳不进去
Path-Alias 插件只负责「点击跳转」，不参与类型检查、补全或报错提示。跳转失败常见于以下情况：
- 文件路径大小写不一致（比如
@/components/Button.vue实际是button.vue）—— 插件严格区分大小写 - 别名后缀没写全，例如写了
import api from '@/api'，但实际文件是api/index.ts—— 插件不会自动补/index - 工作区根目录选错了：VSCode 打开的是子文件夹而非项目根，
${cwd}就指向错误位置 - 插件冲突：同时启用了
Path Intellisense或Alias Navigator，且它们也配置了 alias 映射，优先级混乱
和 tsconfig.json 的 paths 冲突怎么办
两者完全独立，但共存时容易互相干扰：
-
tsconfig.json控制 TS 类型服务（红色波浪线、补全、跳转），影响所有 .ts/.tsx 文件 -
pathAlias.aliasMap只控制 .js/.ts/.vue 等文件中的鼠标点击跳转，不影响类型系统 - 如果你同时配了两者，且值不一致（比如
tsconfig.json里"@/*": ["src/*"]，而pathAlias.aliasMap里"@": "${cwd}/lib"），就会出现「能跳转但报错」或「不报错但跳错」 - 建议：纯 JS 项目用 Path-Alias 单独配；TS 项目优先配
tsconfig.json+TypeScript: Restart TS Server，再按需加 Path-Alias 做补充跳转
Vite/webpack 别名运行正常，但 Path-Alias 不生效
这是设计如此，不是 bug：
-
vite.config.ts的resolve.alias只给 Vite 构建时用，VSCode 完全无视 -
webpack.config.js的resolve.alias同理，只作用于 Webpack 打包阶段 - Path-Alias 插件从不读取这些文件，它只看你手动写的
pathAlias.aliasMap - 所以即使
vite.config.ts里写的是{"@": "/src"}（注意开头斜杠），你也得在插件配置里写成"@": "${cwd}/src"
最常被忽略的一点：插件配置改完后不用重启 VSCode，但必须确保当前编辑的文件属于已配置的工作区——如果只是临时打开一个 .ts 文件，${cwd} 会退化为该文件所在目录，导致映射失效。
