// math.ts
export function add(a: number, b: number): number {
    return a + b;
}

// app.ts
import { add } from './math';
console.log(add(1, 2)); // 输出: 3

模块化优势

作用域隔离：每个模块拥有独立的作用域，避免全局污染
明确依赖关系：通过导入导出清晰地表达模块间的依赖
代码复用：模块可以被多个地方引用，减少重复代码
按需加载：支持动态导入，优化应用性能

模块解析策略

TypeScript支持两种模块解析策略：

Classic：TypeScript传统方式，现主要用于向后兼容
Node：模拟Node.js的模块解析机制，是现代项目的默认选择

配置方式：

json 复制代码

{
  "compilerOptions": {
    "moduleResolution": "node"
  }
}

命名空间：传统组织方式

命名空间基础

命名空间是TypeScript早期提供的代码组织方式，使用namespace关键字：

typescript 复制代码

namespace Utilities {
    export function log(message: string) {
        console.log(message);
    }
}

Utilities.log("Hello from namespace");

命名空间与模块的区别

作用域：
- 模块：文件级作用域
- 命名空间：全局或嵌套作用域
依赖管理：
- 模块：显式导入导出
- 命名空间：通过引用标签(/// <reference path="..."/>)或全局可用
适用场景：
- 模块：现代项目推荐方式
- 命名空间：遗留代码维护或特殊场景

命名空间的现代应用

虽然模块是主流，但命名空间在以下场景仍有价值：

声明合并：扩展第三方类型定义

typescript 复制代码

declare namespace Express {
    interface Request {
        user?: User;
    }
}

复杂类型组织：在.d.ts文件中组织复杂类型

工程化最佳实践

模块化实践建议

文件结构组织：

复制代码

src/
  ├── modules/
  │   ├── auth/
  │   ├── user/
  │   └── ...
  ├── shared/
  └── index.ts

循环依赖处理：
- 使用依赖注入
- 提取公共逻辑到新模块
- 重构代码结构

动态导入优化性能：

typescript 复制代码

async function loadModule() {
    const module = await import('./heavyModule');
    module.run();
}

命名空间与现代模块的结合

在需要同时使用两者时，可以采用以下模式：

typescript 复制代码

// shapes.ts
export namespace Shapes {
    export class Circle { /* ... */ }
    export class Square { /* ... */ }
}

// app.ts
import { Shapes } from './shapes';
const circle = new Shapes.Circle();

迁移策略：从命名空间到模块

对于遗留项目迁移，建议步骤：

配置tsconfig.json启用严格模块检查

json 复制代码

{
  "compilerOptions": {
    "module": "ESNext",
    "isolatedModules": true
  }
}

逐步替换namespace为模块导出
使用工具自动转换引用语法
建立代码规范防止倒退

结论

TypeScript的模块化是现代化大型项目的首选组织方式，提供了清晰的依赖管理和作用域控制。而命名空间在特定场景下仍有其价值，特别是在类型声明和兼容旧代码方面。在实际工程实践中，应根据项目需求和团队规范合理选择，甚至组合使用这两种机制。

随着TypeScript和JavaScript生态的发展，模块化标准不断演进，开发者应当持续关注最新实践，如ES模块的顶级await、import maps等特性，以构建更健壮、可维护的TypeScript应用。