VSCode中paths别名不生效的根本原因是TypeScript语言服务未加载tsconfig.json的compilerOptions.paths配置；需确保tsconfig.json位于根目录、baseUrl设为"."、paths键带"*"通配符、修改后重启TS服务，且Webpack/Vite的alias与TS路径解析互不影响。
VSCode 里 paths 别名不生效，智能提示没反应
根本原因不是 VSCode 配置错了，而是 TypeScript 本身没加载到 tsconfig.json 中的 compilerOptions.paths。VSCode 的 TS 智能提示完全依赖内置的 TypeScript 语言服务，它只认当前工作区根目录下、且被 tsconfig.json 显式启用的配置。
常见错误现象：import utils from "@/utils" 能运行（Webpack/Vite 已配好），但 VSCode 报红、跳转失败、无自动补全。
- 确认
tsconfig.json在项目根目录（不是子文件夹），且文件名大小写正确（tsconfig.json，不是TsConfig.json） -
compilerOptions.baseUrl必须设置，通常为"."；否则paths相对解析会失败 -
paths的 key 必须带通配符，比如"@/*": ["src/*"]，不能写成"@/": ["src/"]（后者在 TS 5.0+ 中部分场景失效） - 修改
tsconfig.json后，必须重启 TS 服务：按Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入 “TypeScript: Restart TS server” 并执行
为什么 Webpack 能解析别名，但 VSCode 提示还是报错
因为 Webpack 和 TypeScript 是两套独立的路径解析逻辑。Webpack 用 resolve.alias，TS 用 baseUrl + paths，二者不互通。VSCode 只看后者，不管前者配得多漂亮。
典型表现：import { foo } from "@/api/user" 在浏览器跑得通，但 VSCode 显示 “Cannot find module '@/api/user' or its corresponding type declarations”。
- 检查
tsconfig.json是否被识别：打开任意.ts文件，右下角状态栏应显示 “TypeScript 5.x.x”（不是 “JavaScript”）；若显示 JS，说明没找到有效 tsconfig，需检查文件位置或工作区设置 - 确保
include或files字段覆盖了当前编辑的源码路径，例如："include": ["src/**/*"]；如果漏掉，TS 服务压根不会检查那些文件 - 不要在
jsconfig.json里配paths期望给 TS 文件用——JS 配置对.ts文件无效
TS 5.0+ 中 paths 配合 moduleResolution: "bundler" 的坑
新版 TS 推荐用 "moduleResolution": "bundler" 替代旧的 "node"，但它对 paths 的行为更严格：只支持带 * 的模式匹配，且要求 baseUrl 存在并可解析。
错误示例："@": ["src"] 在 bundler 模式下无法匹配 @/components/Button，因为缺少通配符。
- 正确写法必须是：
"@/*": ["src/*"]（结尾加/*） - 如果用了
"moduleResolution": "bundler"，建议同时设"module": "nodenext"或"module": "preserve"，避免 ESM 导入被意外转成 CommonJS - 注意 Vite/Webpack 的运行时解析和 TS 编译时解析是分离的，
bundler模式不会让打包工具自动读取tsconfig.paths，仍需各自配置 alias
Node.js 运行时也想用 paths 别名？别指望 TS 配置
tsconfig.json 的 paths 仅用于类型检查和编辑器提示，Node.js 原生不识别它。ESM 环境下直接 node index.js 会报错 “Cannot find module '@utils'”。
想让 Node 运行时也支持，必须额外引入解析层：
- 开发时可用
ts-node+-r tsconfig-paths/register（需安装tsconfig-paths包） - 生产 ESM 构建后，通常已转为相对路径，无需别名；若仍需，得用
import-map或自定义 ESM loader（复杂且非主流） - 别试图用
require('module').createRequire或__dirname手动 resolve —— ESM 不支持__dirname，且破坏树摇和静态分析
最易被忽略的一点：很多人以为配完 tsconfig.paths 就一劳永逸，其实它只管“看得见”的部分。运行时、打包产物、IDE 外部工具（如 ESLint、Jest）都可能需要各自单独配置别名，它们之间互不买账。
