如何在TypeScript中动态校验配置键并赋值，避免重复维护代码？

核心思路 #

用固定合法字段数组结合类型守卫实现，只需要维护字段数组和ConfigFile类型定义，字段变更时仅需修改这两处，无需改动遍历逻辑。

具体实现代码 #

// 定义ConfigFile类型
type ConfigFile = {
  accessToken: string;
  refreshToken: string;
  storageKey: string;
  adminKey: string;
};

// 定义合法字段的只读元组，与ConfigFile字段一一对应
const validConfigKeys = ['accessToken', 'refreshToken', 'storageKey', 'adminKey'] as const;

// 类型守卫：判断输入的key是否属于ConfigFile的合法字段
function isValidConfigKey(key: string): key is keyof ConfigFile {
  return (validConfigKeys as readonly string[]).includes(key);
}

// 模拟CLI输入的键值对（比如从process.argv解析而来）
const cliInput: Record<string, string> = {
  accessToken: 'new-access-token',
  refreshToken: 'new-refresh-token',
  // 非法字段会被自动过滤
  invalidKey: 'ignore-me'
};

// 加载现有配置
let config: ConfigFile = {
  accessToken: 'old-access-token',
  refreshToken: 'old-refresh-token',
  storageKey: 'old-storage-key',
  adminKey: 'old-admin-key'
};

// 遍历输入并更新配置
for (const [key, value] of Object.entries(cliInput)) {
  if (isValidConfigKey(key)) {
    config[key] = value;
  }
}

方案优势 #

• 低维护成本：当ConfigFile新增/删除字段时，只需同步修改validConfigKeys数组和类型定义，遍历逻辑无需改动。
• 类型安全：通过类型守卫确保只有合法字段能被赋值，避免TS类型报错。
• 自动过滤非法输入：CLI传入的无效字段会被自动忽略，避免配置污染。

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