如何在TypeScript中为对象键名实现类型安全并固定键名？

我有一个查询字符串参数对象，该对象只能包含三个键名：a、b和c。如果传入如d = 'some value'这类非法键，TypeScript应抛出错误。我尝试用枚举定义键名，代码如下：

enum queryStringParameters {
  a= 'a',
  b='b',
  c='c'
}

const actionDetails = {
      [queryStringParameters.a]: event.queryStringParameters!.qs1,
      [queryStringParameters.b]: event.queryStringParameters!.qs2,
      [queryStringParameters.c]: event.queryStringParameters!.qs3
    }

请问有没有更好的方式固定对象的键名，同时最好能固定对应的类型？

解决方案 #

方法1：直接用接口/类型别名定义严格结构 #

这是最直观的方式，直接明确指定允许的键和对应类型，TypeScript会自动校验对象的键是否合法，多余键会直接报错：

// 定义固定结构，每个键的类型可按需指定
type ValidQueryParams = {
  a: string; // 比如qs1是字符串就用string，是数字就用number
  b: string;
  c: string;
};

// 声明变量时指定类型，自动校验键和类型
const actionDetails: ValidQueryParams = {
  a: event.queryStringParameters!.qs1,
  b: event.queryStringParameters!.qs2,
  c: event.queryStringParameters!.qs3
};

方法2：枚举+接口/Record（兼顾键名统一管理） #

如果需要在多处统一管理这些键名，保留枚举的同时，用接口或Record约束对象结构：

enum QueryKeys {
  A = 'a',
  B = 'b',
  C = 'c'
}

// 所有键对应同一种类型时用Record
type ValidQueryParams = Record<QueryKeys, string>;

const actionDetails: ValidQueryParams = {
  [QueryKeys.A]: event.queryStringParameters!.qs1,
  [QueryKeys.B]: event.queryStringParameters!.qs2,
  [QueryKeys.C]: event.queryStringParameters!.qs3
};

如果不同键需要不同类型，换成接口定义：

enum QueryKeys {
  A = 'a',
  B = 'b',
  C = 'c'
}

type ValidQueryParams = {
  [QueryKeys.A]: string;
  [QueryKeys.B]: number; // 比如qs2是数字类型
  [QueryKeys.C]: boolean; // qs3是布尔类型
};

const actionDetails: ValidQueryParams = {
  [QueryKeys.A]: event.queryStringParameters!.qs1,
  [QueryKeys.B]: parseInt(event.queryStringParameters!.qs2),
  [QueryKeys.C]: event.queryStringParameters!.qs3 === 'true'
};

方法3：Exact工具类型（处理动态传入的对象） #

如果需要直接校验外部传入的event.queryStringParameters是否符合要求，可以自己实现Exact工具类型，确保没有多余键：

// 实现Exact工具类型，严格匹配结构，多余键会触发报错
type Exact<T, U> = T extends U ? (U extends T ? T : never) : never;

type ValidQueryParams = {
  a: string;
  b: string;
  c: string;
};

// 断言传入对象完全符合结构，非法键会报错
const actionDetails = event.queryStringParameters as Exact<typeof event.queryStringParameters, ValidQueryParams>;

总结 #

• 不需要统一管理键名时，直接用接口/类型别名最简洁，同时兼顾键和类型的约束；
• 需要统一管理键名时，枚举+接口/Record的组合能兼顾复用性和类型校验；
• 处理动态传入的外部对象时，Exact工具类型可以严格过滤多余键。

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