TypeScript：如何覆盖第三方库属性类型？解决重复声明类型错误

你遇到的「Subsequent property declarations must have the same type」错误，是因为TypeScript不允许同名类和接口的属性类型冲突。以下是两种无需修改库文件的可行方案：

方案1：模块扩充（Module Augmentation） #

如果第三方库的Auth是全局声明，或你能定位到它所在的模块，可以通过模块扩充直接覆盖类型：

全局场景下的扩充 #

// 自有文件
declare global {
  class Auth {
    user: Record<string, string | number>; // 移除null类型
  }
}

const a: Auth = {
  user: {
    name: 'joko',
    age: 30
  }
};

const userName = a.user.name; // 无需非空断言，直接使用

模块引入场景下的扩充 #

如果第三方库是通过import引入的，需在对应模块下扩充：

import { Auth } from '第三方库名称';

declare module '第三方库名称' {
  interface Auth {
    user: Record<string, string | number>;
  }
}

const a: Auth = {
  user: {
    name: 'joko',
    age: 30
  }
};

const userName = a.user.name;

方案2：自定义类型包装+类型断言 #

如果模块扩充不适用，可创建移除null类型的自定义类型，再通过类型断言转换实例：

// 定义移除null约束的自定义类型
type NonNullableAuth = Omit<Auth, 'user'> & {
  user: Record<string, string | number>;
};

const a = {
  user: {
    name: 'joko',
    age: 30
  }
} as NonNullableAuth;

const userName = a.user.name; // 直接访问属性

也可以用类型守卫做更严谨的校验：

function hasValidUser(auth: Auth): auth is Omit<Auth, 'user'> & { user: Record<string, string | number> } {
  return auth.user !== null;
}

const a: Auth = {
  user: {
    name: 'joko',
    age: 30
  }
};

if (hasValidUser(a)) {
  const userName = a.user.name; // 此处无需断言
}

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