TypeScript中不导入express如何声明Express类型参数

核心原理 #

TypeScript的类型系统仅在编译阶段生效，类型导入不会被编译为运行时代码，因此不需要担心「重复导入express」的问题——你完全可以在路由文件中单独导入Express类型，不会导致express模块被重复加载，也不违背「仅在main.ts初始化一次express运行时实例」的需求。

修改步骤 #

1. 在路由文件（friends.router.ts）中使用纯类型导入语法引入Express类型，该语法在TS 3.8及以上版本原生支持，编译后会被完全擦除，不会产生任何运行时代码：

   // 仅导入类型，无运行时开销
   import type { Express } from 'express';
   
   export class FriendsRouter {
       private constructor() {}
   
       public static init(app: Express): void {
           app.get('/friends', someMethod);
       }
   }
   

2. 原有main.ts的代码不需要任何修改，可以直接正常运行。

兼容说明 #

如果你使用的TypeScript版本低于3.8，不支持import type语法，也可以直接写普通导入：

import { Express } from 'express';

只要你在该文件中没有调用express的运行时方法（比如express()、express.Router()等），在默认TS配置下，编译时会自动移除未被使用的运行时导入，同样不会产生重复加载的问题。

注意事项 #

不要为了省略导入将app参数标注为any，这会丢失Express实例的所有类型校验和自动补全能力，大幅提升代码出错概率。纯类型导入没有任何运行时成本，是TS项目处理跨文件类型引用的标准实践。

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