当前位置：首页 > news >正文

Node.js -- npm与包

news 2025/12/27 22:11:51

1.包

Node.js中的第三方模块又叫做包
就像电脑和计算机指的是相同的东西，第三方模块和包指的是同一概念，只不过叫法不同。

包的来源：
包是由第三方或者个人团队开发出来的，免费供个人使用。
国外有一家IT 公司，叫做npm,Inc.这家公司旗下有一个非常著名的网站: https://www.npmis.com/，它是全球最大的包共享平台，你可以从这个网站上搜索到任何你需要的包，只要你有足够的耐心!到目前位置，
全球约 1100 多万的开发人员，通过这个包共享平台，开发并共享了超过 120 多万个包供我们使用。
npm,Inc.公司提供了一个地址为 https://registry.npmjis.org/ 的服务器，来对外共享所有的包，我们可以以这个服务器上下载自己所需要的包。

如何下载包：
npm,Inc.公司提供了一个包管理T具，我们可以使用这个包管理工具，从https://registry.npmis.org/ 服务器把需要的包下载到本地使用。
这个包管理工具的名字叫做 Node Package Manager (简称 npm 包管理工具)，这个包管理工具随着 Node.js 的安装包一起被安装到了用户的电脑上。

2.npm初体验

2.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.2 格式化时间的高级做法

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

//导入 moment 包
const moment = require('moment')
// 参考monent 官方 AI 文档，调用对应的方法，对时进行格式化
// 调用 moment() 方法，得到当前的时间6
// 针对当前的时间调用 format() 方法，按照指定的格式进行时间的格式化
const dt  = moment().format('YYYY-MM-DD HH:mm:ss')
console.log(dt) //输出 2020-01-12 17:23:48

3.在项目中安装包的命令

npm install 包的完整名称
npm i 包的完整名称

4.初次装包后多了那些文件

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

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

5.安装制定版本的包

默认情况下，使用 npm install 命今安装包的时候，会自动安装最新版本的包。如果需要安装指定版本的包，可以在包名之后，通过 @ 符号指定具体的版本，例如:

npm i moment@2.22 .2

包的版本号是以“点分十进制”形式进行定义的，总共有三位数字，例如 2.24.0其中每一位数字所代表的的含义如下：

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

6.包管理配置文件

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

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

6.1多人协作问题

整个项目的体积是30M
第三方包的体积是28M
项目源代码的体积是2M
遇到的问题：第三方包体过大，不方便团队成员之间共享项目源代码。

6.2如何记录项目中安装了那些包

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

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

6.3快速创建package.json

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

npm init -y

注意:

上述命令只能在英文的目录下成功运行! 所以，项目文件夹的名称一定要使用英文命名，不要使用中文，不能出现空格
运行 npm install 命令安装包的时候，npm 包管理工具会自动把包的名称和版本号，记录到 package,json 中

7.dependencies节点

packagejson 文件中，有一个 dependencies 节点，专门用来记录您使用 npm install命令安装了哪些包。

8.一次性安装所有的包

可以运行 npm install 命令(或 npm i) -次性安装所有的依赖包:

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

9.卸载包

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

npm uninstall 包的完整名称

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

10.devDependencies节点

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

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

// 安装指定的包，并记录到 devDependencies 节点中
npm i 包名 -D
// 注意:上述命令是简写形式，等价于下面完整的写法
npm install 包名 --save-dev

11. 解决下包速度慢的问题

11.1为什么下包速度慢

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

11.2 淘宝NPM镜像服务器

淘宝在国内搭建了一个服务器，专门把国外官方服务器上的包同步到国内的服务器，然后在国内提供下包的服务。从而极大的提高了下包的速度。
在这里插入图片描述
扩展:镜像(Mirroring)是种文件存储形式，一个磁盘上的数据在另一个磁盘上存在一个完全相同的副本即为镜像

11.3 切换npm下包镜像源

下包镜像源，指的就是下包的服务器地址。

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

11.4 nrm

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

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

12. 包的分类

在这里插入图片描述

13.规范的包结构

在清楚了包的概念、以及如何下载和使用包之后，接下来，我们深入了解一下包的内部结构。
一个规范的包，它的组成结构，必须符合以下 3 点要求

包必须以单独的目录而存在
包的顶级目录下要必须包含 package.json 这个包管理配置文件
packagejson 中必须包含name,version,main 这三个属性，分别代表包的名字、版本号、包的入口.

1.包