TypeScript键值对象类型丢失VSCode自动补全问题

问题出在你定义的Custom是索引签名类型——TypeScript看到这个类型时，会认定这个对象可以拥有任意string类型的键，因此会忽略你初始化时的具体键名，自然就没法提供对应的自动补全了。下面是几种实用的解决思路：

方法一：用satisfies结合const断言（推荐） #

既保留初始化对象的具体键名用于补全，又确保对象符合Custom的类型约束：

type Custom = {
    [key: string]: string
}

const test = {
    a1: 'foo',
    b1: 'bar',
    c1: 'baz',
} as const satisfies Custom;

• as const让TypeScript保留对象键名和值的字面量类型，不会拓宽为string
• satisfies确保对象结构完全符合Custom的要求，同时不丢失具体键的类型信息

方法二：提取字面量类型并结合约束 #

如果需要复用包含具体键的类型，可以先定义对象，再提取它的类型并与Custom结合：

type Custom = {
    [key: string]: string
}

// 先定义对象，让TypeScript自动推导具体键的类型
const testObj = {
    a1: 'foo',
    b1: 'bar',
    c1: 'baz',
};

// 结合Custom的约束和具体键的类型
type CustomWithKeys = typeof testObj & Custom;
const test: CustomWithKeys = testObj;

这种方式适合需要在多个地方复用带具体键的类型的场景。

方法三：去掉显式类型声明（简单场景） #

如果你的需求只是约束对象的键值都是string，不需要支持任意新增的string键，直接让TypeScript自动推导类型即可：

const test = {
    a1: 'foo',
    b1: 'bar',
    c1: 'baz',
};

此时TypeScript会自动推导test的类型为包含a1、b1、c1的具体对象类型，自动补全完全正常，同时键值也都是string类型，满足基础约束。

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