VS Code为何不识别tsconfig路径别名，自动导入仍用相对路径？

问题场景 #

项目结构：

---- apps
---- libs
-------- index.ts
-------- commmon
-------- service
------------ index.ts
------------ src
---------------- index.ts
---------------- goods
-------------------- index.ts
-------------------- src
------------------------ index.ts
------------------------ goods.service.ts

所有index.ts文件均通过export * from '...'向上导出子模块内容。

tsconfig.json配置：

{
  "compilerOptions": {
    "module": "commonjs",
    "declaration": true,
    "removeComments": true,
    "emitDecoratorMetadata": true,
    "experimentalDecorators": true,
    "allowSyntheticDefaultImports": true,
    "target": "es2017",
    "sourceMap": true,
    "outDir": "./dist",
    "baseUrl": "./",
    "incremental": true,
    "skipLibCheck": true,
    "strictNullChecks": false,
    "noImplicitAny": false,
    "strictBindCallApply": false,
    "forceConsistentCasingInFileNames": false,
    "noFallthroughCasesInSwitch": false,
    "paths": {
      "@frosticx/library": [
        "libs"
      ]
    }
  }
}

期望通过import { ... } from '@frosticx/library'导入libs下的内容，但VS Code无法识别该路径别名：自动导入仅给出相对路径建议；手动输入别名虽能正常编译，但VS Code不将其视为合法模块。

解决步骤 #

1. 确认模块导出链完整 #

VS Code的自动导入依赖TypeScript对模块导出的识别，需确保libs/index.ts正确汇总所有子模块的导出内容，示例：

// libs/index.ts
export * from './common';
export * from './service';

子目录的index.ts也要保持向上导出的链路完整，比如service/index.ts需导出src目录下的内容，以此类推。

2. 重启TypeScript服务 #

VS Code可能缓存旧配置，按快捷键Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入TypeScript: Restart TS Server，重启服务后重新加载配置。

3. 统一多tsconfig配置（如有） #

若项目存在多个tsconfig.json（比如apps目录下有独立配置），需确保子配置继承根目录的路径别名设置，可在子配置中添加：

{
  "extends": "../tsconfig.json",
  // 其他自定义配置
}

或在子配置中重复声明baseUrl和paths字段。

4. 安装@types/node（可选） #

部分场景下缺少Node.js类型定义会导致模块识别异常，执行以下命令安装：

npm install @types/node --save-dev

5. 配置VS Code导入偏好（可选） #

若以上步骤无效，可在VS Code工作区或用户设置（settings.json）中添加以下配置，强制优先使用非相对路径（别名）进行自动导入：

{
  "typescript.preferences.importModuleSpecifier": "non-relative",
  "typescript.suggest.paths": true
}

内容的提问来源于stack exchange，提问作者Hhry