VSCode不识别路径别名是因为只认tsconfig.json/jsconfig.json的baseUrl和paths配置，而非Webpack/Vite的resolve.alias；需正确设置baseUrl="./"、paths带通配符、include覆盖源码目录，并重启TS Server，同时开启javascript.suggest.autoImports和typescript.suggest.autoImports。
插件装完了，但项目路径还是不识别？
不是插件没生效，而是 VSCode 本身不自动读取 Webpack/Vite 的 resolve.alias 或构建配置里的路径别名。它只认 tsconfig.json 或 jsconfig.json 中的 compilerOptions.baseUrl 和 paths。哪怕你配了 @/components 在 Vite 里跑得飞起，VSCode 也当看不见。
必须手动配置 tsconfig.json 或 jsconfig.json
在项目根目录下创建或修改 tsconfig.json（TypeScript 项目）或 jsconfig.json（纯 JavaScript 项目），写入标准路径映射：
{
"compilerOptions": {
"baseUrl": "./",
"paths": {
"@/*": ["src/*"],
"@assets/*": ["src/assets/*"],
"@utils/*": ["src/utils/*"]
}
},
"include": ["src/**/*"]
}
注意三点：
-
include必须覆盖你实际用到的文件路径，漏掉tests/或pages/就会导致对应目录下的路径无法解析 -
baseUrl设为"./"是最稳妥的，设成"src"或其他值容易引发相对路径错乱 - 改完后必须重启 TS Server：按
Ctrl+Shift+P→ 输入Restart TS server→ 回车；否则新配置不加载
VSCode 自动导入开关默认是关的
即使路径配置全对、TS Server 也重启了，import 补全时依然不会自动插入 import XXX from '@utils/foo' —— 因为 javascript.suggest.autoImports 和 typescript.suggest.autoImports 默认是 false。
打开设置（Ctrl+,），搜 autoImports，把这两项都勾上；或者直接编辑 settings.json：
"javascript.suggest.autoImports": true, "typescript.suggest.autoImports": true
别只开一个，JS 和 TS 是分开控制的。
Path Intellisense 插件的映射要和项目配置一致
如果你装了 Path Intellisense 插件来补全路径（比如输入 @/ 弹出 components/），它的映射必须和 tsconfig.json 保持一致，否则会出现「补全能出来，但跳转失败」或「跳转到了错误目录」的问题。
在 settings.json 中配：
"path-intellisense.mappings": {
"@": "${workspaceFolder}/src"
}
常见坑：
-
${workspaceFolder}不是${workspaceRoot}（后者已弃用） - Windows 用户如果发现补全路径用了
\而不是/，可在插件设置里启用path-intellisense.forceUnixStyle - 插件不会解析动态拼接路径，例如
require('@/' + name)它完全不识别
最常被忽略的是：路径补全、跳转、自动 import 这三件事依赖不同机制，各自独立生效，缺一不可。配错任意一环，都会让你觉得“插件装了但没用”。
