TypeScript 学习笔记之 Module

妖狐艹你老母 2022-05-10 13:20 291阅读 0赞

TS 中的 Module 的概念兼容 ES 2015 中 Module 的概念。

## 简介 ##

模块中的代码属于模块本身的作用域，而不是全局作用域。也这就意味着没有明确的 `export` 的话，模块中的 变量，函数，类等对其他模块是不见的。相对的其他模块要使用某一模块的内容需要通过 `import` 导入。

## Export ##

1.  导出一个声明：通过在声明前加 `export` 关键词修饰即可导出。
2.  导出语句：也可以像 `import` 语句的逆形式一样，通过类似如下的语句导出：

export { User };
    export { User as BaseMember };

1.  从其他模块中导出: `export { User as BaseMember } from "./users" }`
2.  从其他模块中导出全部： `export * from ".users"`

## Import ##

1.  从模块中导入单个导出： `import { User} from "./users"`
2.  导出时重命名 : `import { User as BaseMember} from "./users"`
3.  从模块中导入全部到一个变量名中:`import * as users from "./users"`
4.  单纯的导入模块以执行模块: `import "./my-module.js"`

## Default exports ##

每一个模块都有一个可选的默认导出. 在 `export` 后面加 `default` 关键字。  
`default` 导出也支持导出字面量。如: `export default "123";`

### `export =` 和 `import = require()` ###

在 CommonJS 和 AMD 模块系统中都一个 `exports` 的变量，用来包装一个模块的所有导出。为了兼容这些模块系统。 TS 也支持 `export =` 的语法来导出模块的单个对象。但是注意 `export =` 必须和 `import module = require("module")` 搭配使用。

## 导入其他的 JS 库 ##

在 TS 的术语中把没有定义实现的声明称之为 `ambient` 。这些声明一般定义在 `.d.ts` 文件中。你可以把他们理解成 `c/c++` 中的头文件。

### Ambient Modules ###

例如有一个名为 `node.d.ts` 的文件。  
然后便可以将下面一样来导入：

/// <reference path="node.d.ts"/>
    import * as URL from "url";
    let myUrl = URL.parse("http://demo.com");

TS 也提供了不提供模块的具体的声明文，来导入 JS 库的支持。  
即提供一种简写的方式：  
如下 `declarations.d.ts`

declare module "hot-new-module";

这样模块中所有的导入的类型都将是 `any` 类型。  
`import x, {y} from "hot-new-module";`

## Guidance for structuring modules ##

1.  导出层级不要太深。从模块中导出一个 namespace 加增加一个层级。如果没有必要不要增加层级 。
2.  如果只导出一个单一的类或函数，使用 `export default`。
3.  导出多个对象时，把他们放在最顶层。
4.  显式的列出所有要导入的名字。
5.  如果要导入很多的东西的时候，可以考虑使用 namespace 导入模式。  
    如 `import * as largeModule from "./MyLargeModule.ts";`
6.  通过 re-export 来扩展。
7.  不要在模块中使用 namespaces。

作者：一半晴天  
链接：https://www.jianshu.com/p/30a8c7dc85db  
來源：简书  
简书著作权归作者所有，任何形式的转载都请联系作者获得授权并注明出处。