本文共 8989 字，大约阅读时间需要 29 分钟。

--------------------------- npm与包 -------------------------------

3.1 包

1. Node.js 中的第三方模块又叫做包

2. 来源

不同于 Node.js 中的内置模块与自定义模块，包是由第三方个人或团队开发出来的，免费供所有人使用。

注意：Node.js 中的包都是免费且开源的，不需要付费即可免费下载使用。

3. 为什么需要包

由于 Node.js 的内置模块仅提供了一些底层的 API，导致在基于内置模块进行项目开发的时，效率很低。

包是基于内置模块封装出来的，提供了更高级、更方便的 API，极大的提高了开发效率。 包和内置模块之间的关系，类似于 jQuery 和 浏览器内置 API 之间的关系。

4. 从哪里下载包 （国外有一家 IT 公司，叫做 npm, Inc）

https://www.npmjs.com/ 它是全球最大的包共享平台，你可以从这个网站上搜索到任何你需要的包，只要你有足够的耐心！

npm, Inc. 公司提供了一个地址为 https://registry.npmjs.org/ 的服务器，来对外共享所有的包，我们可以从这个服务器上下载自己所需要的包。

注意：

1. 从 https://www.npmjs.com/ 网站上搜索自己所需要的包
2. 从 https://registry.npmjs.org/ 服务器上下载自己需要的包

5. 如何下载包

npm, Inc. 公司提供了一个包管理工具，我们可以使用这个包管理工具，

从 https://registry.npmjs.org/ 服务器把需要的包下载到本地使用。

这个包管理工具的名字叫做 Node Package Manager（简称 npm 包管理工具），这个包管理工具随着 Node.js 的安装包一起被安装到了用户的电脑上。

大家可以在终端中执行 npm -v 命令，来查看自己电脑上所安装的 npm 包管理工具的版本号：

在终端中 输入   npm -v 查看版本号

3.2 npm 初体验

**1. 格式化时间的 传统做法 **

1. 创建格式化时间的自定义模块
2. 定义格式化时间的方法
3. 创建补零函数
4. 从自定义模块中导出格式化时间的函数
5. 导入格式化时间的自定义模块
6. 调用格式化时间的函数

1.// 1. 定义格式化时间的方法function dateFormat(dtStr) {     const dt = new Date(dtStr)  const y = dt.getFullYear()  const m = padZero(dt.getMonth() + 1)  const d = padZero(dt.getDate())  const hh = padZero(dt.getHours())  const mm = padZero(dt.getMinutes())  const ss = padZero(dt.getSeconds())  return `${     y}-${     m}-${     d} ${     hh}:${     mm}:${     ss}`}// 定义补零的函数function padZero(n) {     return n > 9 ? n : '0' + n}module.exports = {     dateFormat}2.// 导入自定义的格式化时间的模块const TIME = require('./15.dateFormat')// 调用方法，进行时间的格式化const dt = new Date()    // console.log(dt)const newDT = TIME.dateFormat(dt)console.log(newDT)

2. 格式化时间的高级做法

1. 使用 npm 包管理工具，在项目中安装格式化时间的包 moment
2. 使用 require() 导入格式化时间的包
3. 参考 moment 的官方 API 文档对时间进行格式化

// 1. 导入需要的包// 注意：导入的名称，就是装包时候的名称const moment = require('moment')moment() 得到当前的时间format() 按照指定的格式进行时间格式化const dt = moment().format('YYYY-MM-DD HH:mm:ss')console.log(dt)  // 输出 时间

3. 在项目中安装包的命令 或者 安装指定版本的包

如果想在项目中安装指定名称的包，需要运行如下的命令：

npm install 包的完整名称	或者 简写格式	npm i 包的完整名称	安装指定版本的包	npm i 包的名称@2.22.2  // 后面是版本符号

4. 包的语义化版本规范

包的版本号是以“点分十进制”形式进行定义的，总共有三位数字，例如 2.24.0

其中每一位数字所代表的的含义如下：

1. 第1位数字：大版本
2. 第2位数字：功能版本
3. 第3位数字：Bug修复版本

版本号提升的规则：只要前面的版本号增长了，则后面的版本号归零。

5. 初次装包后多了哪些文件

初次装包完成后，在项目文件夹下多一个叫做 node_modules 的文件夹和 package-lock.json 的配置文件。

其中：

1. node_modules 文件夹用来存放所有已安装到项目中的包。require() 导入第三方包时，就是从这个目录中查找并加载包。
2. package-lock.json 配置文件用来记录 node_modules 目录下的每一个包的下载信息，例如包的名字、版本号、下载地址等。

注意：程序员不要手动修改 node_modules 或 package-lock.json 文件中的任何代码，npm 包管理工具会自动维护它们。

3.3 包管理配置文件

npm 规定，在项目根目录中，必须提供一个叫做 package.json 的包管理配置文件。用来记录与项目有关的一些配置

信息。例如：

1. 项目的名称、版本号、描述等
2. 项目中都用到了哪些包
3. 哪些包只在 开发期间 会用到
4. 那些包在 开发和部署时 都需要用到

**1. 遇到的问题：**第三方包的体积过大，不方便团队成员之间共享项目源代码。

解决方案：共享时剔除node_modules

2. 如何记录项目中安装了哪些包

在项目根目录中，创建一个叫做 package.json 的配置文件，即可用来记录项目中安装了哪些包。从而方便剔除node_modules 目录之后，在团队成员之间共享项目的源代码。

**注意：**今后在项目开发中，一定要把 node_modules 文件夹，添加到 .gitignore 忽略文件中。

3. 快速创建 package.json

npm 包管理工具提供了一个快捷命令，可以在执行命令时所处的目录中，快速创建 package.json 这个包管理配置文件：

在执行命令所处的目录中， 快速 新建 package.json 文件	npm init -y	注意：	1. 上述命令只能在英文的目录下成功运行！		所以，项目文件夹的名称一定要使用英文命名，不要使用中文，不能出现空格。 			2.  运行 npm install 命令安装包的时候，npm 包管理工具会自动把包的名称和版本号，		记录到 package.json 中。

4. dependencies 节点

package.json 文件中，有一个 dependencies 节点，专门用来记录您使用 npm install

命令安装了哪些包。

5. 一次性安装所有的包

当我们拿到一个剔除了 node_modules 的项目之后，需要先把所有的包下载到项目中，才能将项目运行起来。否则会报类似于下面的错误：

由于项目中依赖这个包运行， 如果 没有提前安装这个包， 就会报以下错误	Error: Cannot find module 'moment'

可以运行 **npm install 命令（或 npm i）**一次性安装所有的依赖包：

执行 npm install 命令时， npm 包 管理工具会先读取 package.json 中的 dependencies 节点	读取到记录的所以依赖包名称和版本号之后， npm 包管理工具 就会把这些包一次性下载到项目中	npm install

6. 卸载包

可以运行 npm uninstall 命令，来卸载指定的包：

npm uninstall moment（包名称）

注意：npm uninstall 命令执行成功后，会把卸载的包，自动从 package.json 的 dependencies 中移除掉

7. devDependencies 节点

如果某些包只在项目开发阶段会用到，在项目上线之后不会用到，则建议把这些包记录到 devDependencies 节点中。

与之对应的，如果某些包在开发和项目上线之后都需要用到，则建议把这些包记录到 dependencies 节点中。

您可以使用如下的命令，将包记录到 devDependencies 节点中：

安装指定的包，并记录到 devDependencies 节点中	npm i 包名称 -D  （简写）	或	npm install 包名 --save-dev

3.4 解决下包速度慢的问题

在使用 npm 下包的时候，默认从国外的 https://registry.npmjs.org/ 服务器进行下载，此时，网络数据的传输需要经过漫长的海底光缆，因此下包速度会很慢。

1. 淘宝 NPM 镜像服务器

淘宝在国内搭建了一个服务器，专门把国外官方服务器上的包同步到国内的服务器，然后在国内提供下包的服务。从而极大的提高了下包的速度。

扩展：

镜像（Mirroring）是一种文件存储形式，一个磁盘上的数据在另一个磁盘上存在一个完全相同的副本即为镜像

2. 切换 npm 的下包镜像源（下包的镜像源，指的就是下包的服务器地址）

查看当前的下包镜像源	npm cofig get registry	将下包的镜像 切换 为淘宝镜像源	npm config set registry=https://registry.npm.taobao.org/	检查镜像源是否下载成功	npm config get registry

3. nrm

为了更方便的切换下包的镜像源，我们可以安装 nrm 这个小工具，利用 nrm 提供的终端命令，可以快速查看和切换下包的镜像源

通过 npm 包管理器，将 nrm 安装为全局可用的工具	npm i nrm -g	查看所有可用的镜像源	nrm Is	将下包的镜像源切换为 taobao 镜像	nrm use taobao

3.5 包的分类

使用 npm 包管理工具下载的包，共分为两大类，分别是： 项目包 、 全局包

1. 项目包

那些被安装到项目的 node_modules 目录中的包，都是项目包。

项目包又分为两类，分别是：

1. 开发依赖包（被记录到 devDependencies 节点中的包，只在开发期间会用到）
2. 核心依赖包（被记录到 dependencies 节点中的包，在开发期间和项目上线之后都会用到）

npm i 包名 -D     开发依赖包    devDependencies 节点中的包	npm i 包名        核心依赖包    dependencies 节点中的包

2. 全局包

在执行 npm install 命令时，如果提供了 -g 参数，则会把包安装为全局包。

全局包会被安装到 C:\Users\用户目录\AppData\Roaming\npm\node_modules 目录下。

npm i 包名 -g   全局安装指定的包	npm unistall 包名 -g    卸载全局安装的的包	注意：	1.只有**工具性质的包**，才有全局安装的必要性。因为它们提供了好用的终端命令。	2.判断某个包是否需要全局安装后才能使用，可以参考官方提供的使用说明即可。

3. i5ting_toc

i5ting_toc 是一个可以把 md 文档转为 html 页面的小工具，使用步骤如下：

npm install -g i5ting_toc  将他 安装为全局包	i5ting_toc -f 要转换的md文件路径 -o  调用它，实现 md 转 html 的功能

3.6 规范的包结构

在清楚了包的概念、以及如何下载和使用包之后，接下来，我们深入了解一下包的内部结构。

一个规范的包，它的组成结构，必须符合以下 3 点要求：

1. 包必须以单独的目录而存在
2. 包的顶级目录下要必须包含 package.json 这个包管理配置文件
3. package.json 中必须包含 name，version，main 这三个属性，分别代表包的名字、版本号、包的入口。
   关于更多的约束，可以参考如下网址：https://yarnpkg.com/zh-Hans/docs/package-json

3.7 开发属于自己的包

1. 需要实现的功能

① 格式化日期 ② 转义 HTML 中的特殊字符 ③ 还原 HTML 中的特殊字符

2. 初始化包的基本结构

① 新建 itheima-tools 文件夹，作为包的根目录 ② 在 itheima-tools 文件夹中，新建如下三个文件：

1. package.json （包管理配置文件）
2. index.js （包的入口文件）
3. README.md （包的说明文档）

3. 初始化 package.json

{     "name": "itheima-tools",  "version": "1.1.0",  "main": "index.js",  "description": "提供了格式化时间、HTMLEscape相关的功能",  "keywords": [    "itheima",    "dateFormat",    "escape"  ],  "license": "ISC"}

4. 在 index.js 中定义格式化时间的方法

// 定义格式化时间的函数function dateFormat(dateStr) {     const dt = new Date(dateStr)  const y = dt.getFullYear()  const m = padZero(dt.getMonth() + 1)  const d = padZero(dt.getDate())  const hh = padZero(dt.getHours())  const mm = padZero(dt.getMinutes())  const ss = padZero(dt.getSeconds())  return `${     y}-${     m}-${     d} ${     hh}:${     mm}:${     ss}`}// 定义一个补零的函数function padZero(n) {     return n > 9 ? n : '0' + n}

5. 在 index.js 中定义 转义 HTML 的方法 和 还原 HTML 的方法

// 定义转义 HTML 字符的函数function htmlEscape(htmlstr) {       return htmlstr.replace(/<|>|"|&/g, match => {           switch (match) {               case '<':                return '<'            case '>':                return '>'            case '"':                return '"'            case '&':                return '&'        }    })}// 定义还原 HTML 字符串的函数function htmlUnEscape(str) {       return str.replace(/<|>|"|&/g, match => {           switch (match) {               case '<':                return '<'            case '>':                return '>'            case '"':                return '"'            case '&':                return '&'        }    })}

7. 将不同的功能进行模块化拆分

1. 将格式化时间的功能，拆分到 src -> dateFormat.js 中
2. 将处理 HTML 字符串的功能，拆分到 src -> htmlEscape.js 中
3. 在 index.js 中，导入两个模块，得到需要向外共享的方法
4. 在 index.js 中，使用 module.exports 把对应的方法共享出去

8. 编写包的说明文档

1. 包根目录中的 README.md 文件，是包的使用说明文档。通过它，我们可以事先把包的使用说明，以 markdown 的格式写出来，方便用户参考。
2. README 文件中具体写什么内容，没有强制性的要求；只要能够清晰地把包的作用、用法、注意事项等描述清楚即可。
3. 我们所创建的这个包的 README.md 文档中，会包含以下 6 项内容：
4. 安装方式、导入方式、格式化时间、转义 HTML 中的特殊字符、还原 HTML 中的特殊字符、开源协议

3.8 发布包

1. 注册 npm 账号

2. 登录 npm 账号 （在终端中登录）

   npm 账号注册完成后，可以在终端中执行 npm login 命令，依次输入用户名、密码、邮箱后，即可登录成功。
   （注意：在运行 npm login 命令之前，必须先把下包的服务器地址切换为 npm 的官方服务器。否则会导致发布包失败！）

3. 把包发布到 npm 上

   将终端切换到包的根目录之后，运行 npm publish 命令，即可将包发布到 npm 上（注意：包名不能雷同）。

4. 删除已发布的包

   运行 npm unpublish 包名 --force 命令，即可从 npm 删除已发布的包。
   注意：
   ① npm unpublish 命令只能删除 72 小时以内发布的包
   ② npm unpublish 删除的包，在 24 小时内不允许重复发布
   ③ 发布包的时候要慎重，尽量不要往 npm 上发布没有意义的包！

--------------------------- 模块的加载机制 -----------------------------

4.1 优先从缓存中加载

模块在第一次加载后会被缓存。 这也意味着多次调用 require() 不会导致模块的代码被执行多次。

注意：不论是内置模块、用户自定义模块、还是第三方模块，它们都会优先从缓存中加载，从而提高模块的加载效率。

4.2 内置模块的加载机制

内置模块是由 Node.js 官方提供的模块，内置模块的加载优先级最高。

例如，require(‘fs’) 始终返回内置的 fs 模块，即使在 node_modules 目录下有名字相同的包也叫做 fs。

4.3 自定义模块的加载机制

使用 require() 加载自定义模块时，必须指定以 ./ 或 …/ 开头的路径标识符。在加载自定义模块时，如果没有指定 ./ 或 …/ 这样的路径标识符，则 node 会把它当作内置模块或第三方模块进行加载。

同时，在使用 require() 导入自定义模块时，如果省略了文件的扩展名，则 Node.js 会按顺序分别尝试加载以下的文件：

1. 按照确切的文件名进行加载
2. 补全 .js 扩展名进行加载
3. 补全 .json 扩展名进行加载
4. 补全 .node 扩展名进行加载
5. 加载失败，终端报错

4.4 第三方模块的加载机制

如果传递给 require() 的模块标识符不是一个内置模块，也没有以 ‘./’ 或 ‘…/’ 开头，则 Node.js 会从当前模块的父目录开始，尝试从 /node_modules 文件夹中加载第三方模块。

如果没有找到对应的第三方模块，则移动到再上一层父目录中，进行加载，直到文件系统的根目录

例如，假设在 ‘C:\Users\itheima\project\foo.js’ 文件里调用了 require(‘tools’)，则 Node.js 会按以下顺序查找：

1. C:\Users\itheima\project\node_modules\tools
2. C:\Users\itheima\node_modules\tools
3. C:\Users\node_modules\tools
4. C:\node_modules\tools

4.5 目录作为模块

当把目录作为模块标识符，传递给 require() 进行加载的时候，有三种加载方式：

1. 在被加载的目录下查找一个叫做 package.json 的文件，并寻找 main 属性，作为 require() 加载的入口
2. 如果目录里没有 package.json 文件，或者 main 入口不存在或无法解析，则 Node.js 将会试图加载目录下的 index.js 文件。
3. 如果以上两步都失败了，则 Node.js 会在终端打印错误消息，报告模块的缺失：Error: Cannot find module ‘xxx’

转载地址：http://kgzsz.baihongyu.com/