TypeScript Partial类型赋值报Error 2322的合理解决方案咨询

问题根源 #

当你把keyof Person类型的键存储为普通string变量时，TypeScript会自动将变量类型拓宽为string，而非保留具体的键名类型。后续赋值时，TypeScript无法确认这个string键是否属于Person的合法键，因此抛出类型不匹配错误。而初始化对象时直接用键赋值，TypeScript能直接推断键的类型为keyof Person，所以不会报错。

规范处理方案 #

1. 锁定键的类型（推荐） #

通过const声明或as const断言，让TypeScript保留键的具体类型，避免类型拓宽：

type Person = {
  name: string;
  age: number;
};

const person: Partial<Person> = {};
// 方式1：明确指定变量类型为keyof Person
const key: keyof Person = 'name';
person[key] = 'Alice'; // 正常赋值

// 方式2：用as const断言锁定类型
const key = 'name' as const;
person[key] = 'Bob'; // 正常赋值

2. 类型断言（适合动态场景） #

如果键必须是string类型，可在赋值时将键断言为keyof Person：

const person: Partial<Person> = {};
let key: string = 'age';
// 断言键为合法的Person键
person[key as keyof Person] = 30; // 正常赋值

3. 泛型函数封装（适合批量/复用场景） #

封装一个泛型函数，约束键和值的类型匹配，从根源上避免类型问题：

type Person = {
  name: string;
  age: number;
};

function setPersonProp<T extends keyof Person>(
  person: Partial<Person>,
  key: T,
  value: Person[T]
) {
  person[key] = value;
}

const person: Partial<Person> = {};
let key: string = 'name';
// 调用时断言键类型，函数会自动匹配值的类型
setPersonProp(person, key as keyof Person, 'Charlie');

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