如何为TypeScript中含动态路径的updates对象添加类型标注？

DevOps 小满

2026-8-18

TypeScript动态属性对象的类型标注方案

针对动态属性路径的对象类型标注问题，有以下几种可行方案：

1. 字符串索引签名（最通用）

如果无需限制键的具体格式，仅需要约束值的类型，直接用字符串索引签名即可：

// 先定义data对应的类型，示例为Post
type Post = {
  title: string;
  content: string;
};

// 定义updates的类型
type Updates = {
  [key: string]: Post;
};

const updates: Updates = {};
updates[`/posts/${selectedCategory}/${Date.now()}`] = data;

这种方式简单直接，适用于键格式不固定的场景，缺点是无法校验键的格式是否符合预期。

2. 模板字面量类型（约束键格式）

如果键的格式是固定模式（比如/posts/{分类}/{时间戳}），可以用模板字面量类型严格约束键的结构：

// 先限定分类的可能取值（如果分类是固定枚举）
type PostCategory = 'tech' | 'life' | 'sports';
// 定义符合格式的键类型
type PostKey = `/posts/${PostCategory}/${number}`;
type Post = {
  title: string;
  content: string;
};

// 定义updates为可选属性的对象类型
type Updates = {
  [K in PostKey]?: Post;
};

const updates: Updates = {};
// 若selectedCategory是动态值，需用类型断言缩小范围
updates[`/posts/${selectedCategory as PostCategory}/${Date.now()}`] = data;

这种方式可以确保键的格式完全符合预期，但需要提前明确分类的可选值，若分类是完全动态的（比如用户输入），则不太适用。

3. Record工具类型（简洁语法糖）

Record是TypeScript内置的工具类型，本质是索引签名的简化写法，适合快速定义键值对类型：

type Post = {
  title: string;
  content: string;
};

// Record<键类型, 值类型>
const updates: Record<string, Post> = {};
updates[`/posts/${selectedCategory}/${Date.now()}`] = data;

和索引签名效果一致，写法更简洁。