面试题：TypeScript接口声明合并与模块系统的深度结合

Question

在一个基于TypeScript的大型模块化项目中，不同模块都可能声明同名接口，且这些接口会相互合并。请描述如何通过合理的模块结构设计和接口声明合并，来确保代码的可维护性和扩展性，同时避免命名冲突和不必要的接口合并错误。并举例说明在实际场景中如何实现这一点。

Answer 1

模块结构设计

1. 按功能划分模块：将相关功能的代码组织到同一个模块中，比如用户相关功能放在user模块，订单相关功能放在order模块。这样不同功能模块间接口同名概率降低。例如：

// user.module.ts
export interface User {
    id: number;
    name: string;
}

// order.module.ts
export interface Order {
    id: number;
    product: string;
}

2. 使用命名空间：在模块内部，对接口进行命名空间划分。当接口逻辑上有分组需求时，这很有用。例如：

// utils.module.ts
export namespace MathUtils {
    export interface Add {
        (a: number, b: number): number;
    }
    export interface Subtract {
        (a: number, b: number): number;
    }
}

接口声明合并

1. 谨慎使用全局接口：尽量避免在全局作用域声明接口，因为全局作用域下同名接口会自动合并，难以控制和维护。如果确实需要全局接口，要进行严格的命名规范，如使用项目名前缀。
2. 明确模块内接口合并：在模块内，如果有同名接口合并需求，确保合并逻辑清晰。例如：

// animal.module.ts
export interface Animal {
    name: string;
}
export interface Animal {
    age: number;
}
// 合并后Animal接口有name和age属性

实际场景实现

假设我们正在开发一个电商系统，有商品模块和购物车模块。

1. 商品模块：

// product.module.ts
export interface Product {
    id: number;
    name: string;
    price: number;
}

2. 购物车模块：

// cart.module.ts
export interface Product {
    quantity: number;
}
// 这里Product接口与product.module.ts中的Product接口同名，但合并后会同时有id、name、price、quantity属性
// 为避免混淆，可在购物车模块使用更明确的命名，如CartProduct
export interface CartProduct extends Product {
    quantity: number;
}

通过这种方式，既利用了接口合并的特性，又避免了命名冲突和不必要的合并错误，提高了代码的可维护性和扩展性。