📋 介绍 ★

Partial 是 TypeScript 的内置工具类型，用于将 一个类型的所有属性 变为可选。

🎯 核心作用 ★★

创建 现有类型的”部分”版本，所有字段都变成可选的。

📝 基本语法 ★

Partial<类型>

💡 经典示例 ★

// 原始用户类型
interface User {
  id: number
  name: string
  email: string
  age: number
}

// 使用 Partial
type PartialUser = Partial<User>
// 等价于：
// interface PartialUser {
//   id?: number
//   name?: string
//   email?: string
//   age?: number
// }

🔧 实际应用场景

1. 更新数据

// 用户更新接口
function updateUser(id: number, data: Partial<User>) {
  // 可以只更新部分字段
  return api.put(`/users/${id}`, data)
}

// 使用：只更新邮箱
updateUser(1, { email: 'new@email.com' })

// 使用：只更新姓名
updateUser(1, { name: '新名字' })

// 使用：更新多个字段
updateUser(1, { name: '新名字', age: 25 })

2. 表单数据

// 创建用户时所有字段必填
function createUser(data: User) { /* ... */ }

// 更新用户时部分字段可选
function updateUser(data: Partial<User>) { /* ... */ }

3. 默认配置

// 完整配置
interface Config {
  theme: string
  fontSize: number
  language: string
}

// 用户可能只设置部分配置
function saveUserConfig(config: Partial<Config>) {
  // 合并到默认配置
  const finalConfig = { ...defaultConfig, ...config }
  // 保存...
}

⚡ 主要特点

优点

✅ 灵活更新：允许只更新部分字段
✅ 类型安全：保持字段类型约束
✅ 代码复用：基于现有类型创建
✅ 易于理解：明确表示”部分数据”

注意事项

⚠️ 编译时：只在 TypeScript 编译时起作用
⚠️ 可选链：使用时要注意字段可能为 undefined
⚠️ 默认值：可能需要处理缺失字段

🔄 与 Required 对比

interface User {
  id?: number
  name?: string
}

// Partial 让可选更明确
type CreateUser = Partial<User>  // id?, name?

// Required 让必填更明确
type StrictUser = Required<User>  // id: number, name: string

📈 性能考虑

Partial 是编译时类型操作，没有运行时开销：

// TypeScript 源码
type UpdateData = Partial<User>

// 编译为 JavaScript
// 完全消失，不影响运行时性能

🎓 记住这几点

1. 内置工具：TypeScript 自带，无需安装
2. 编译时：只在开发阶段起作用
3. 类型安全：字段名和类型仍然受约束
4. 实际场景：常用于更新操作
5. 组合使用：常与 Pick、Omit 等结合

📋 总结

Partial 是 TypeScript 的类型操作工具，用于创建现有类型的可选版本，特别适合更新操作和部分数据场景。