TSRPC项目中全局类型声明的使用限制与解决方案

全局类型声明在TSRPC中的限制

在TypeScript开发中，我们经常使用declare global语法来扩展全局命名空间，实现全局类型的声明。然而，在TSRPC项目中，这种常规的全局类型声明方式可能会遇到无法正常工作的情况。

TSRPC框架为了确保协议依赖的所有类型能够被明确追踪和管理，设计了一套类型收敛机制。这意味着所有在TSRPC协议中使用的类型都必须有明确的import来源，而不能依赖于全局命名空间的类型声明。这种设计带来了以下优势：

1. 类型可追踪性：所有类型都有明确的定义位置，便于维护和查找
2. 项目可移植性：类型定义集中管理，方便在不同项目间同步协议
3. 开发规范性：避免了全局命名空间污染，减少潜在的命名冲突

解决方案：类型别名模式

虽然TSRPC限制了全局类型的直接使用，但我们仍然可以通过类型别名的方式实现类似功能。具体实现方式如下：

1. 在协议文件中定义基础类型：

// protocols/xxx.ts
export interface ProtocolType {
  id: number;
  name: string;
}

2. 创建全局类型别名：

// src/global.ts
declare global {
  type GlobalType = import('../protocols/xxx').ProtocolType;
}

这种模式既满足了TSRPC对类型来源明确性的要求，又实现了类型在全局范围内的可用性。

最佳实践建议

1. 优先使用显式导入：在可能的情况下，尽量使用显式的import语句而非全局类型，这有助于代码的可维护性

2. 集中管理全局类型：将所有全局类型别名集中在一个文件中管理，便于维护

3. 类型命名规范：为全局类型别名添加特定前缀或后缀，避免命名冲突

4. 文档记录：对全局可用的类型进行文档说明，方便团队成员理解

通过这种方式，开发者可以在遵循TSRPC设计原则的同时，灵活地使用全局类型，实现项目的需求。