为什么TypeScript中导出的type类型导入时被识别为命名空间？

错误根因 #

你的问题确实和tsconfig路径配置有关，同时存在类型导入规则的问题，具体原因如下：

• 路径匹配错误：你导出options类型的文件是src/common/requests/index.tsx，但tsconfig中common/requests的路径映射指向了后缀为.ts的文件，且路径开头的/写法不符合baseUrl: "."的相对路径规则，TS无法正确匹配到你导出类型的文件，误将对应目录识别为了命名空间。
• 类型导入不规范：未使用专用的类型导入语法，TS识别跨文件导出的类型时容易和值/命名空间混淆，触发误报。
• 额外冲突项：你的tsconfig中同时开启了emitDeclarationOnly: true和noEmit: true，两个配置互斥，noEmit优先级更高会禁止所有文件输出，也会影响类型声明的识别。

修复步骤 #

1. 修正tsconfig.json的paths配置，调整路径写法和文件后缀：

{
  "compilerOptions": {
    // 其他原有配置保持不变
    "paths": {
      "common/*": [
        "./src/common/*"
      ],
      "common/requests": [
        "./src/common/requests/index.tsx"
      ],
      "common/requests/env": [
        "./src/common/requests/ENV.ts"
      ]
    },
    // 若你需要生成类型声明文件，删掉冲突的noEmit配置即可
    // "noEmit": true
  }
}

2. 将fileB中的导入改为类型专用导入：

// 修改导入语句为type only导入
import type { options } from 'common/requests';

type option<T> = options<T>;

3. 可选校验：检查src/common/requests目录下是否存在名为options的同名文件/命名空间声明，避免命名冲突。

内容的提问来源于stack exchange，提问作者Kuroneko黑猫