如何在运行时检测TypeScript interface指定字段是否为必填项

TypeScript 类型系统仅在编译阶段生效，所有 interface、类型别名的元信息会在编译为 JavaScript 后完全擦除，原生运行时无法直接读取 interface 的字段必填属性，需要配合编译时工具实现需求，没有纯运行时的原生实现方案。

方案1：使用Zod等Schema定义库（生产环境主流方案） #

通过Schema库可以同时定义运行时校验规则和推导TypeScript类型，直接读取字段的必填标记：

import { z } from 'zod'

// 定义运行时可用的Schema
const PersonSchema = z.object({
  name: z.string(),
  age: z.number().optional(),
  occupation: z.string().optional()
})

// 从Schema推导TS类型，和直接定义interface效果完全一致
type Person = z.infer<typeof PersonSchema>

// 实现isRequired工具函数
function isRequired<T extends z.ZodObject<any>>(schema: T, field: keyof z.infer<T>): boolean {
  return !schema.shape[field].isOptional()
}

// 业务代码使用
const person: Person = { name: '张三' }
const fields = ['name', 'age', 'occupation'] as const

fields.forEach(field => {
  if (isRequired(PersonSchema, field)) {
    // 执行必填字段对应的逻辑
  } else {
    // 执行可选字段对应的逻辑
  }
})

该方案无需修改编译配置，同时自带字段校验能力，是目前社区最常用的实现方式。

方案2：自定义TypeScript Transformer生成必填字段数组 #

如果不想引入第三方Schema库，可以通过自定义TS编译插件，在编译阶段把指定interface的必填字段生成为运行时可用的常量数组，符合你提到的「编译阶段生成必填字段内部数组」的思路：

// 编译前手动定义的interface
interface Person {
  name: string
  age?: number
  occupation?: string
}

// 自定义Transformer会在编译阶段自动生成以下常量
const PersonRequiredFields = ['name'] as const

// 实现isRequired工具函数
function isRequired(requiredFields: readonly string[], field: string): boolean {
  return requiredFields.includes(field)
}

// 业务代码使用
const fields = ['name', 'age', 'occupation']
fields.forEach(field => {
  if (isRequired(PersonRequiredFields, field)) {
    // 执行必填字段对应的逻辑
  } else {
    // 执行可选字段对应的逻辑
  }
})

该方案需要修改编译配置，比如使用ttypescript替换默认的tsc，或者在Webpack、Vite等打包工具中配置对应的loader加载自定义Transformer，适合对编译流程有管控能力的项目。

注意事项 #

不要尝试通过运行时判断实例是否存在某字段来推导必填性：可选字段允许被赋值，必填字段如果关闭了编译时非空校验也可能在运行时不存在，实例本身不携带类型的必填性元信息。

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