TypeScript路径别名失效：VS Code模块导入报错解决方案

1. 修复导入拼写错误 #

首先检查another-package/src/index.ts中的导入语句：

import { SomeType } from '@company/some-ackage'

这里存在拼写错误，some-ackage应为some-package，修正后：

import { SomeType } from '@company/some-package'

2. 完善tsconfig.json配置 #

当前tsconfig.json缺少include字段，TypeScript无法自动扫描packages目录下的文件，需要添加该字段：

{
  "compilerOptions": {
    "baseUrl": "./packages",
    "paths": {
      "@company/some-package/*": ["some-package/src/*"],
      "@company/another-package/*": ["another-package/src/*"]
    }
  },
  "include": ["packages/**/*"]
}

3. 配置子包的package.json（可选但推荐） #

在some-package和another-package目录下分别创建package.json，明确包的名称和类型入口：

packages/some-package/package.json：

{
  "name": "@company/some-package",
  "types": "./src/index.ts",
  "main": "./src/index.ts"
}

packages/another-package/package.json：

{
  "name": "@company/another-package",
  "types": "./src/index.ts",
  "main": "./src/index.ts"
}

4. 重启VS Code的TypeScript服务 #

如果修改后错误仍未消失，按下Ctrl+Shift+P（Windows）或Cmd+Shift+P（Mac），搜索并执行TypeScript: Restart TS Server，刷新TypeScript语言服务。

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