0Pricing
TypeScript Academy · 课时

命名空间与模块：现代用法

理解为什么模块优先于命名空间

命名空间与模块：现代用法 是 CoddyKit 上的免费 TypeScript Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 TypeScript Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 TypeScript Academy 课程共包含 4 节课。

欢迎

TypeScript 最初使用命名空间（以前称为“内部模块”）来组织代码。现代 TypeScript 则使用 ES 模块。本课将讲解各自适用的场景。

什么是命名空间

命名空间是 TypeScript 特有的一种方式，使用 `namespace` 关键字将相关代码归入具有名称的作用域中。
namespace Geometry {
  export interface Point { x: number; y: number; }
  export function distance(a: Point, b: Point): number {
    return Math.sqrt((a.x - b.x) ** 2 + (a.y - b.y) ** 2);
  }
}

访问命名空间成员

通过命名空间名称和点号表示法访问命名空间成员。
const p1: Geometry.Point = { x: 0, y: 0 };
const p2: Geometry.Point = { x: 3, y: 4 };
const d = Geometry.distance(p1, p2); // 5

嵌套命名空间

命名空间可以嵌套。
namespace App {
  export namespace Models {
    export interface User { name: string; }
  }
}
const u: App.Models.User = { name: 'Alice' };

命名空间合并

命名空间支持声明合并——具有相同名称的两个命名空间声明会被合并。
namespace Validation {
  export function validate(s: string): boolean { return s.length > 0; }
}
namespace Validation {
  export function sanitize(s: string): string { return s.trim(); }
}

为什么优先使用模块

ES 模块是 JavaScript 标准。所有打包工具都支持它们，可以高效地进行树摇，并且能够在现代浏览器和 Node.js 中原生运行。

命名空间对应的模块写法

在现代 TypeScript 中，一个命名空间就对应一个文件。将需要公开的内容导出，其余内容保持私有。
// geometry.ts
export interface Point { x: number; y: number; }
export function distance(a: Point, b: Point): number {
  return Math.sqrt((a.x - b.x) ** 2 + (a.y - b.y) ** 2);
}

声明文件中仍会使用命名空间

命名空间在全局库的 .d.ts 声明文件中仍被广泛使用（例如 DOM 类型和 Node.js 类型），因为它们可以扩展全局作用域。
// node.d.ts
declare namespace NodeJS {
  interface ProcessEnv { NODE_ENV?: 'development' | 'production'; }
}

三斜线引用（旧式写法）

在 ES 模块出现之前，三斜线指令用于引用其他文件。如今可以使用 tsconfig 的 includes 和模块导入来替代它们。
/// <reference types="node" />
/// <reference path="./other.d.ts" />

仍应使用命名空间的场景

请在以下场景使用命名空间：(1) 在声明文件中定义环境全局类型；(2) 扩展库提供的现有全局命名空间。

从命名空间迁移到模块

将 `namespace Foo {}` 替换为模块文件。将 `/// ` 替换为导入语句。TypeScript 团队已经记录了这条迁移路径。

快速检查

在现代 TypeScript 中，命名空间的推荐替代方案是什么？

回顾

命名空间可以将代码组织到具有名称的作用域中，但在现代 TypeScript 中已经属于旧式写法。应用程序代码应使用 ES 模块（import/export）。在声明文件中，命名空间仍适用于扩展全局类型。

常见问题解答

「命名空间与模块：现代用法」课时是免费的吗？

是的 — 「命名空间与模块：现代用法」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 TypeScript Academy 课程的其余内容，请升级到 CoddyKit PRO。 TypeScript Academy 课程共包含 4 节课。

「命名空间与模块：现代用法」这节课中我会学到什么？

理解为什么模块优先于命名空间 你通过在浏览器中直接运行的动手代码来练习 TypeScript Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 TypeScript Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 TypeScript Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。

「命名空间与模块：现代用法」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 TypeScript Academy 课中编写并运行代码吗？

能。每节 TypeScript Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. ES 模块语法：import 与 export
  2. 重新导出与集中导出文件
  3. 仅用于类型的导入与导出
  4. 命名空间与模块：现代用法
← 返回 TypeScript Academy