TypeScript中如何兼顾对象类型定义与自动补全功能？

核心是通过TypeScript的泛型或satisfies运算符，既约束对象的键必须符合大写规则，又保留对象的字面量类型，从而获得自动补全和无效键报错。

方案1：泛型工厂函数（兼容所有TS版本） #

用泛型函数接收对象，约束它符合URLDefinition的同时，保留字面量类型：

type URLDefinition = {
  [key: Uppercase<string>]: string;
};

// 泛型函数：约束输入符合规则，同时保留原对象的字面量类型
const createURLConfig = <T extends URLDefinition>(obj: T) => obj as const;

// 使用示例
const General = createURLConfig({
  BASE: "api/",
});

const Search = createURLConfig({
  ACCOUNTS: "api/v1/accounts",
  lowerPath: "api/v1", // 直接报错 ❌，键不符合大写要求
});

console.log(General.WRONG); // 报错：不存在属性"WRONG" ✅
console.log(General.BASE); // 自动补全正常 ✅

方案2：satisfies运算符（TS 4.9+推荐） #

satisfies是专门为这种场景设计的——它会约束变量符合指定类型，但不会覆盖变量的推导类型，完美兼顾约束和自动补全：

type URLDefinition = {
  [key: Uppercase<string>]: string;
};

const General = {
  BASE: "api/",
} as const satisfies URLDefinition;

const Search = {
  ACCOUNTS: "api/v1/accounts",
  lowerPath: "api/v1", // 报错：不符合URLDefinition类型 ❌
} as const satisfies URLDefinition;

console.log(General.WRONG); // 报错：不存在属性"WRONG" ✅
console.log(General.BASE); // 自动补全正常 ✅

原写法问题解析 #

• 直接写const General: URLDefinition：TypeScript会把变量类型拓宽为索引签名类型，认为任何大写键都合法，所以General.WRONG不报错，也没有具体键的自动补全。
• 不加类型约束：无法检测小写键的错误，因为TS不会自动约束键的格式。

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