TypeScript同名枚举兼容问题：相同定义为何报错？

TypeScript 里的枚举是名义类型，和接口、类型别名遵循的结构类型规则完全不同——哪怕两个枚举的成员名、值完全一模一样，只要是分开声明的（一个来自外部模块导入，一个是本地重新定义），TypeScript 就会把它们当成完全无关的两种类型。

当你把本地枚举的实例赋值给需要外部枚举类型的参数时，TypeScript 会严格校验类型的“归属”，而不是只看结构是否匹配，这就导致了 TS2345（类型不匹配）和 TS90010（枚举类型不兼容）错误。

举个直观的例子：

// 外部模块 external.ts
export enum DocumentOrigin {
  Local = 'LOCAL',
  Remote = 'REMOTE'
}

// 你的本地文件 IDocumentFilingDto.ts
enum DocumentOrigin {
  Local = 'LOCAL',
  Remote = 'REMOTE'
}

// 假设外部模块的接口
interface IDocumentFilingDtoGen {
  origin: import('./external').DocumentOrigin;
}

const localOrigin: DocumentOrigin = DocumentOrigin.Local;
// 这里会直接报错，因为两个DocumentOrigin是不同类型
const dto: IDocumentFilingDtoGen = { origin: localOrigin };

可行的解决办法 #

• 统一枚举来源：直接导入外部的 DocumentOrigin 枚举使用，不要在本地重复定义，这是最稳妥的方案，从根源避免类型冲突。
• 用联合类型替代枚举：如果一定要本地定义，可以换成结构兼容的字符串联合类型，联合类型遵循结构类型规则，相同定义会被视为兼容：

  type DocumentOrigin = 'LOCAL' | 'REMOTE';
  

• 临时用类型断言绕过：如果只是临时调试或兼容，可以用类型断言强制转换，但不推荐长期使用，会丢失 TypeScript 的类型安全保障：

  const dto: IDocumentFilingDtoGen = { origin: localOrigin as import('./external').DocumentOrigin };
  

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