如何在不实例化的情况下检查TypeScript类型是否包含指定属性？

TypeScript的类型是编译时概念，运行时会被完全擦除，所以没法直接用运行时API（比如Object.hasOwn）去检查类型属性。但可以通过编译时类型工具或轻量的类型断言技巧来实现需求，不用初始化全量属性：

方法一：编译时类型验证（纯类型层面） #

用条件类型让TypeScript在编译阶段直接告诉你属性是否存在，不会生成任何运行时代码：

// 定义通用类型检查工具
type HasProperty<T, PropertyName extends string | number | symbol> = 
  PropertyName extends keyof T ? true : false;

// 针对你的Mutations类型做验证
type HasUpsertItem = HasProperty<Mutations, 'upsertItem'>; // 推断为true（属性存在）
type HasInvalidProp = HasProperty<Mutations, 'invalidProp'>; // 推断为false（属性不存在）

如果属性不存在，你在使用HasInvalidProp时，TS会明确给出类型推断结果，相当于编译时的"检查"。

方法二：轻量断言+编译时检查（适合开发阶段快速验证） #

创建一个空对象并断言为目标类型，利用TS的类型检查能力在编译阶段判断属性是否存在：

// 用类型断言绕过全量初始化要求
const mutations = {} as Mutations;

// 编译时：如果'upsertItem'不存在，TS会直接报错
// 运行时：因为对象是空的，这里结果是false，但编译阶段已经完成属性存在性验证
if ('upsertItem' in mutations) {
  // 进入分支时，TS会自动推断mutations包含upsertItem属性
}

// 或者用可选链做快速判断（同样是编译时检查优先）
const hasTargetProp = !!mutations?.upsertItem;

这个方法的核心是利用TS的编译时检查，运行时的结果不重要，主要是帮你在开发阶段确认属性是否存在。

方法三：运行时属性检查（需要生成键列表） #

如果必须在运行时做检查，需要先拿到类型对应的属性键列表。可以通过类型断言生成键数组：

// 编译时获取所有属性键，断言为运行时数组
const mutationKeys = Object.keys({} as Mutations) as Array<keyof Mutations>;

// 运行时检查属性是否存在
console.log(mutationKeys.includes('upsertItem')); // true
console.log(mutationKeys.includes('invalidProp')); // false

注意：如果你的Mutations类型包含可选属性或字符串索引签名，这个方法的结果可能不准确，因为Object.keys不会包含未定义的可选属性。

为什么你之前的代码报错？ #

• var mutations: Mutations;只是声明了变量的类型，但变量本身是undefined，运行时调用Object.hasOwn自然会报错。
• let mutations: Mutations = {};报错是因为Mutations的属性都是必填的，空对象不满足类型要求，用as Mutations断言可以绕过这个限制。

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