TypeScript中如何通过点语法为命名空间动态赋值？

问题分析 #

直接通过点语法给空命名空间赋值时，TypeScript会抛出Property 'item1' does not exist on type 'typeof item'错误，原因是默认命名空间的类型未包含待赋值的属性声明。多次扩展命名空间虽然可行，但写法繁琐。

解决方案 #

通过接口与命名空间的类型合并，既能支持点语法直接赋值，又能保留智能提示，还允许跨文件拆分属性定义：

1. 先定义统一的属性类型

type ItemType = {
  name: string;
};

2. 声明与命名空间同名的接口，添加索引签名和需要的属性声明（触发智能提示）

// 基础接口定义，可放在公共文件
interface item {
  [key: string]: ItemType; // 允许任意字符串键的ItemType类型属性
  item1?: ItemType; // 提前声明属性以触发智能提示
}

3. 定义命名空间，TypeScript会自动合并接口与命名空间的类型

namespace item {}

4. 直接用点语法赋值，无报错

item.item1 = { name: "Some Item" };

跨文件扩展属性 #

在其他文件中，只需扩展同名接口并添加新属性，即可支持跨文件赋值和智能提示：

// 其他文件中扩展接口
interface item {
  item2?: ItemType;
}

// 直接赋值
item.item2 = { name: "Another Item" };

关键说明 #

• 接口与命名空间同名时，TypeScript会自动合并它们的类型，让命名空间继承接口的索引签名和属性声明。
• 智能提示依赖接口中明确的属性声明，若需要新增属性的提示，必须在接口中提前声明或扩展接口添加。

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