如何在TypeScript中避免命名空间重复及新增约束方法

单次新增的静态约束（TypeScript） #

先定义已有命名空间的类型，再通过Exclude工具类型排除这些值，确保新对象的namespace是从未使用过的字符串：

// 已有命名空间类型
type ExistingNamespaces = 'first' | 'second' | 'third';
// 原对象类型
type OriginalObject = { namespace: ExistingNamespaces };

// 新对象类型：排除所有已有命名空间
type NewObject = { namespace: Exclude<string, ExistingNamespaces> };

// 合法示例
const validNewObj: NewObject = { namespace: 'fourth' };
// 非法示例（TypeScript会直接报错）
const invalidNewObj: NewObject = { namespace: 'first' };

多次新增的动态约束（TypeScript） #

如果需要后续每次新增都自动约束namespace不重复，可以通过泛型累积已使用的命名空间集合，让TypeScript自动跟踪已有的值：

方式1：手动维护已用命名空间类型 #

// 工具类型：约束新namespace不属于已用集合
type NewObjWithUniqueNs<T extends string> = {
  namespace: Exclude<string, T>;
};

// 初始已用命名空间
type UsedNs = 'first' | 'second' | 'third';

// 第一次新增后，更新已用命名空间类型
type UsedNsAfterFirstAdd = UsedNs | 'fourth';
const firstNewObj: NewObjWithUniqueNs<UsedNs> = { namespace: 'fourth' };

// 第二次新增时，基于更新后的已用集合约束
const secondNewObj: NewObjWithUniqueNs<UsedNsAfterFirstAdd> = { namespace: 'fifth' };
// 非法示例（报错）
const duplicateObj: NewObjWithUniqueNs<UsedNsAfterFirstAdd> = { namespace: 'fourth' };

方式2：用函数自动推断已用集合 #

通过函数封装，让TypeScript自动从数组中推断已用命名空间，无需手动更新类型：

function addUniqueNsObj<T extends string>(
  usedNs: readonly T[],
  newObj: { namespace: Exclude<string, T> }
) {
  // 返回包含新命名空间的只读数组，TypeScript会自动更新已用集合类型
  return [...usedNs, newObj.namespace] as const;
}

// 初始已用命名空间（readonly数组确保类型固定）
const initialUsedNs = ['first', 'second', 'third'] as const;

// 第一次新增，自动更新已用集合类型
const updatedNs1 = addUniqueNsObj(initialUsedNs, { namespace: 'fourth' });
// 第二次新增，基于更新后的集合约束
const updatedNs2 = addUniqueNsObj(updatedNs1, { namespace: 'fifth' });
// 尝试新增重复值会直接报错
addUniqueNsObj(updatedNs2, { namespace: 'fourth' });

运行时约束（JavaScript/TypeScript通用） #

如果需要在运行时确保不重复（比如处理动态输入），可以维护一个已用命名空间的数组，新增前做检查：

// 维护已用命名空间的集合
const usedNamespaces = ['first', 'second', 'third'];

function createNewObj(namespace) {
  if (usedNamespaces.includes(namespace)) {
    throw new Error(`命名空间 "${namespace}" 已存在，请使用新值`);
  }
  // 添加到已用集合
  usedNamespaces.push(namespace);
  return { namespace };
}

// 合法创建
const newObj1 = createNewObj('fourth');
// 抛出错误（重复值）
createNewObj('first');

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