第41章 命名空间

案例41:命名空间——用namespace组织几何计算工具

题目:使用TypeScript命名空间将点、圆、面积计算等几何相关代码组织为独立模块,避免全局命名冲突。

设计思路

通过namespace将类型定义与纯函数封装在Geometry命名空间内,外部通过完全限定名访问。用枚举表示图形类型,接口描述点与圆,函数计算面积并格式化输出。

核心代码

namespace Geometry {
  export enum ShapeType { Circle, Unknown }

  export interface Point { x: number; y: number }

  export interface Circle {
    center: Point
    radius: number
    type: ShapeType.Circle
  }

  export function createCircle(cx: number, cy: number, r: number): Circle {
    return { center: { x: cx, y: cy }, radius: r, type: ShapeType.Circle }
  }

  export function area(c: Circle): number {
    return Math.PI * c.radius ** 2
  }
}

const c = Geometry.createCircle(0, 0, 5)
console.log(`圆的面积:${Geometry.area(c).toFixed(2)}`)
console.log(`类型标签:${Geometry.ShapeType[Geometry.ShapeType.Circle]}`)

运行结果验证

使用tsc 41-namespace.ts && node 41-namespace.js,输出:

成功要点

圆的面积:78.54
类型标签:Circle — 命名空间内所有成员正常导出并访问。

注意事项

警告

若未加export关键字,命名空间外部无法访问内部成员。同时避免嵌套过深,单层namespace足够小型项目使用。

扩展建议

可将命名空间拆分为多个文件,配合--outFile合并;或改用ES模块方式,但namespace更适合简单脚本场景。