在 TypeScript 中复用已有 Interface 的部分属性：完整指南

在使用 TypeScript 进行类型定义时，经常会遇到这样的场景：你已经定义了一个接口（Interface），但在另一个类型中只需要它的一部分属性。为了避免重复定义、提升可维护性，我们可以利用 TypeScript 提供的一些工具类型和语言特性来"提取"已有接口中的部分属性。

本文将系统总结这些方法，并举例说明其使用场景与注意事项。

---

场景示例

interface User {
  id: number
  name: string
  email: string
  isAdmin: boolean
}

你可能只想要 User 接口中的 id 和 name，而不需要其他字段。这种需求很常见，比如你要定义一个 UserPreview 类型用于展示列表中的用户信息。

---

1. 使用 Pick<T, K> ------ 精准选取需要的字段

语法：

type Picked = Pick<原始类型, '属性1' | '属性2'>

示例：

type UserPreview = Pick<User, 'id' | 'name'>

说明：

这是最常见也是最安全的方式，明确指定需要复用的字段名。

---

2. 使用 Omit<T, K> ------ 排除不需要的字段

语法：

type Omitted = Omit<原始类型, '不需要的属性1' | '不需要的属性2'>

示例：

type UserPublic = Omit<User, 'email' | 'isAdmin'>

说明：

适合只想移除少数字段的场景。

---

3. 使用索引访问类型（手动方式）

语法：

type FieldType = 原始类型['属性名']

示例：

type UserId = User['id'] // number

或者组合成新的接口：

interface UserIdName {
  id: User['id']
  name: User['name']
}

说明：

灵活但不太适合选取多个属性时使用，容易出错、冗长。

---

4. 使用映射类型（动态选择部分属性）

如果你有一个属性列表，可以用映射类型结合 Pick 实现动态选择：

type Keys = 'id' | 'name'
type UserPreview = {
  [K in Keys]: User[K]
}

等价于：

type UserPreview = Pick<User, 'id' | 'name'>

说明：

适合属性名是动态字符串联合类型的场景。

---

5. 使用 Partial<T> + Pick<T, K>（提取后变成可选）

语法：

type OptionalPreview = Partial<Pick<User, 'email' | 'isAdmin'>>

示例：

const userOpt: OptionalPreview = {
  email: '[email protected]'
}

说明：

适用于只需要部分字段，且这些字段是可选的场景。

---

6. 结合多个工具类型（进阶）

type BaseInfo = Pick<User, 'id' | 'name'>
type AdminInfo = Pick<User, 'isAdmin'>
type Combined = BaseInfo & AdminInfo

说明：

可以组合多个提取结果形成新的类型。

---

总结对比表

方法	适用场景	优点	缺点
Pick<T, K>	精确选择少量字段	简洁明确	需手动列出字段
Omit<T, K>	排除少数字段	快速移除不需要的字段	对大接口易漏字段
索引类型	选单个字段	非常灵活	不适合多个字段
映射类型	属性名动态	灵活构建新接口	稍复杂
Partial + Pick	部分字段可选	适合配置类结构	可选性可能不合需求
组合工具类型	多种需求组合	高扩展性	可读性稍差

---

最佳实践建议

• 常用： 使用 Pick 或 Omit 是最安全、最推荐的方式。
• 动态属性： 使用映射类型。
• 不重复写类型： 如果属性名已经是联合类型，建议结合映射。
• 只要一个字段的类型： 用 T['field'] 更简洁。

---

如果你对接口属性复用有更多自定义或复杂的场景，也可以结合 infer、条件类型等高级用法来构建更灵活的类型系统。