一文详解Node.js中的npm与包【万字教程】

本篇文章带大家了解一下node中的npm与包，万字教学~超超超详细

包

什么是包

Node.js中的第三方模块又叫做包，指的是同一种东西，知识叫法不同

包的来源

不同于Node.js的内置模块与自定义模块，包是由第三方个人或团队开发出来的，免费供所有人使用。【相关教程推荐：nodejs视频教程】

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

为什么需要包

由于Node.js的内置模块仅提供了一些底层的api，导致在基于内置模块进行项目开发的时候，效率很低，包是基于内置模块封装出来的，提供了更高级，更方便的api。极大地提高了开发效率。包和内置模块之间的关系，类似于jquery和浏览器内置api之间的关系。

从哪里下载

国外有一家IT公司，叫做npm，lnc。这家公司旗下有一个非常著名的网站，全球最大的包共享平台

你可以从这个网站上搜索到任何你需要的包，只要你有足够的耐心！

到目前为止，全球约有1100万左右的开发人员，通过这个包共享平台，开发并共享了超过120多万个包供我们使用。 

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

如何下载包

npm，lnc公司提供了一个包管理工具，我么可以使用这个包管理工具，从https://registry.npmjs.org/服务器上吧所需要的包下载到本地使用。

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

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

npm初体验

格式化时间的传统做法

实现步骤

• 创建格式化事件的自定义模块

• 自定格式化时间的方法

• 创建补零函数

• 从自定义模块中导出格式化时间的函数

• 导入格式化时间的自定义模块

• 调用格式化时间的函数

实现代码

自定义时间格式化模块

//定义格式化时间的方法
function dataFormat(data) {
    //接受字符串创建对象
    const dt = new Date(data);
    //年
    const Y = dt.getFullYear();
    //月
    const m = format(dt.getMonth() + 1);
    //日
    const d = format(dt.getDay());
    //时
    const hh = format(dt.getHours());
    //分
    const mm = format(dt.getMinutes());
    //秒
    const ss = format(dt.getSeconds());
    return `${Y}-${m}-${d} ${hh}:${mm}:${ss}`;
 
}
//补零操作
function format(data) {
    return data > 9 ? data : '0' + data;
}
//暴露对象
module.exports = { dataFormat };

       大家注意曝光这里要用module.exports，因为这里引用了新的对象，或者修改引用对象添加属性，可以使用exports。

exports.dataFormat = dataFormat;

         使用模块

//导入模块
const data = require('./自定义模块/格式化时间模块.js');
//创建未格式化对象
let olddata = new Date();
console.log(olddata);
//调用格式化模块
let newdata = data.dataFormat(olddata)
console.log(newdata);

利用包格式化时间

                步骤

• 使用npm包管理工具，在项目中安装格式化时间的包 moment

• 使用require（）导入包

• 参考moment的官方api文档学习了解使用方法

                 安装包

在当前终端中输入

npm install moment

• npm 包管理工具

• install  安装 可简写成 i

• moment  包名称

下载包之后 可以在上面提到的网站内搜索moment 查看api文档学习使用方法，网站是英文的，也可以在csdn内进行搜索一般也可以找到教学文章。

                实现代码

//导入包
const moment = require('moment');
//格式化事件
//单词要大写
const newdate = moment().format('YYYY-MM-DD HH:MM:SS');
console.log(newdate);

安装包后的相关文件

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

其中

node_modules文件夹用来存放所有已安装到项目中的包，require（）导入第三方包时，就是从这个目录中查找并加载的包，

package-lock.json配置文件用来记录node_modules目录下的每一个包的下载信息，例如包的名字信息，版本号等。

注意：不需要修改两个文件中的任何东西，npm包会自动维护。

安装指定版本的包

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

npm i moment @ 1.1.12

包的语义化版本规范

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

期中没一位数字所代表的含义如下

第一位数字：大版本

第二位数字：功能版本

第三位数字：bug修复版本

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

npm与包

包管理配置文件

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

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

多人协作的问题 

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

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

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

快速创建package.json

npm包管理工具提供了一个快捷命令，可以在执行命令时所处的目录中，快速创建package.json这个包管理配置文件，在我们安装第三方包的时候 如果没有package.json也会自动生成一个（里面只有安装的包的信息）。

npm init -y

注意：上述命令只能在英文的目录下成功运行，所以需要保证项目文件所处的父级目录要是英文名。

建议 建立文件夹后 就执行此命令先创建一个package.son。

安装包的时候  会自动将相关信息写入package.json文件中。

dependdencies节点

package.json文件中，有一个dependencies节点，专门用来记录您使用npm i命令安装了哪些包

一次性安装的所有的包 

当我们拿到一个提出了node_modules的项目之后，启动项目会报错，提示没有所需要的包，苏一在启动项目之前。我们应该安装所有需要的包，package.jaon中记录的包，然后才能运行起来。

npm  install

我们只需要执行这个命令，执行这个命令后，会读取package.json中所有以来的包，并下载。

卸载包

npm uninstall  包名

这个是不能简写的，卸载之后 也会将包名从 package.json文件中删除，

devDependencies节点

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

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

npm  install   包名 -D

只需要在结尾加个-D就可以将包安装在devDependencies中    

解决下包速度慢问题

为什么下包速度慢

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

淘宝NPM镜像服务器

淘宝在国内搭建了一个服务器，专门把国外服务器的包同步到国内的服务器，然后我们可以再从国内的服务器上下载包，这样就可以大大提高包的下载速度。

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

切换npm的下包镜像源

查看当前下包的服务器地址

Khroma

AI调色盘生成工具

下载

npm config get registry

 切换淘宝服务器

npm config set registry=https://registry:npm:taobao.org/

nrm

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

npm i nrm -g

-g全局下载，

查看所有可用的镜像源

nrm ls

nrm use taobao

包的分类

项目包

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

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

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

全局包

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

全局包安装包查看位置命令

npm config ls

注意： 只有工具性质的包 才有全局安装的必要性。

i5ting_toc

作为程序员，md文档的编写往往是必要的，md文档编写简易快捷，是不二的笔记语言。

这是一个可以把md文档转为html页面的小工具，这种工具性质的包 就是有必要全卷装的，便于我们日后使用。

安装

npm i  i5ting_toc -g

使用

i5ting_toc -f 文件路径 -o

规范的包结构

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

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

• 包必须以单独的目录而存在

• 包的顶级目录下要必须包含package.json这个配置文件

• package.json中必须包含name，version，main这三个属性，分别代表包的名字，版本号，包的入口。

开发属于自己的包

需要实现的功能

• 格式化日期

• 转义HTML中的特殊字符

• 还原HTML中的特殊字符

初始化包的基本结构

1、新建itheima-tools文件夹，作为包的根目录

2、在itheima-tools文件夹中，新建如下三个文件

• package.json  包管理配置文件
• index.js 包入口文件
• README.md  包的说明文档 

初始化package.json

{
    "name": "itheima-tools-xiepu",
    "version": "1.0.0",
    "main": "index.js",
    "description": "提供了格式化时间。转义功能",
    "keywords": ["xiepu","tools","format"],
    "license": "ISC"
}

• name  制作的npm包的名称  之后导入包 搜索包 都是这个名字 这个名字不可重复 建议命名之前现在npm网站内搜索一下是否重名
• version 版本号
• main 主文件路径 到我们使用导入这个包的时候。就会自动执行这个js里面的内容
• description  这是对包的描述
• keywords  包的关键字 在网站内搜索时的关键字
• license 遵循的开源许可协议

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

可以直接粘贴我们之前写的自定义包函数

//定义格式化时间的方法
function dataFormat(data) {
    //接受字符串创建对象
    const dt = new Date(data);
    //年
    const Y = dt.getFullYear();
    //月
    const m = format(dt.getMonth() + 1);
    //日
    const d = format(dt.getDay());
    //时
    const hh = format(dt.getHours());
    //分
    const mm = format(dt.getMinutes());
    //秒
    const ss = format(dt.getSeconds());
    return `${Y}-${m}-${d} ${hh}:${mm}:${ss}`;

}
//补零操作
function format(data) {
    return data > 9 ? data : '0' + data;
}
//暴露对象
exports.dataFormat = dataFormat;

在index.js中定义转义html的方法

//定义转义字符函数
function htmlstr(hstr) {
    return hstr.replace(/<|>|"|&/g, data => {
        switch (data) {
            case '<':

                return '<';

            case '>':
                return '>';
            case '"':
                return '"';
            case '&':
                return '&';
        }
    })
}
//暴露对象
exports.htmlstr = htmlstr;

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

function htmlstr1(hstr) {
    return hstr.replace(/<|>|"|&/g, data => {
        switch (data) {
            case '<':

                return '<';

            case '>':
                return '>';
            case '"':
                return '"';
            case '&':
                return '&';
        }
    })
}
//暴露对象
exports.htmlstr1 = htmlstr1;

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

• 将格式化时间的功能，拆分到src dataFormat.js中

• 将处理html字符串的功能，拆分到src htmlstr.js中

• 在index.js中，导入两个模块，得到需要向外共享的方法

• 在index.js中，使用module.exports把对应的方法共享出去

 将格式化时间，和字符串转义各自分别放到独立的js中(创立一个src文件夹)，并进行暴露。 

然后在主页index.js中，进行导入和曝光。

const htmlstr = require('./src/htmlstr');
const dataFormat = require('./src/dataFormat');



module.exports = {
    htmlstr,
    dataFormat
}

调用测试

const itheima = require('../itheima-tools');

console.log(itheima.dataFormat.dataFormat(new Date()));
const str = '<h1>232</h1>';
console.log(itheima.htmlstr.htmlstr(str));
console.log(itheima.htmlstr.htmlstr1(str));

 详细说一下这里，我们首先调用的index.js这个模块，可以看到导入只写了文件夹没写index.js，这种写法同样也可以导入index.js，它会去寻找package.json里的main属性，所以会导入index.js，导入index.js之后，我们又从index.js中导入了另外两个转义和格式化时间模块，所以在使用属性时

是这样一个过程 itheima这个模块里的htmlstr模块里的htmlstr属性。

那么可不可以不写的那么复杂？ 

答案是可以的  我们只要在itheima这个模块里 直接曝光出所有属性就好，这里我们可以在itheima模块中使用es6的展开属性...直接将相关内容曝光在对象内。

index.js

const htmlstr = require('./src/htmlstr');
const dataFormat = require('./src/dataFormat');



module.exports = {
    ...htmlstr,
    ...dataFormat
}

ceshi.js

const itheima = require('../itheima-tools');

console.log(itheima.dataFormat(new Date()));
const str = '<h1>232</h1>';
console.log(itheima.htmlstr(str));
console.log(itheima.htmlstr1(str));

编写包的说明文档

说明文档内容没有强制性要求，只要能清晰的包的作用，注意点写好就可以，书写内容大致有以下六点

• 安装方式

• 导入方式

• 格式化时间

• 转义html中的特殊字符

• 还原html中的特殊字符

• 开源协议

 大家可以去学习一下markdown文档编写的语法 并不难

## 安装
"
npm install itheima-tools-xiaoxie
"
## 导入
"
const name = require ('itheima-tools-xiaoxie')
"
## 格式化时间
"
console.log(itheima.dataFormat(new Date()));

"
## 转义html字符
"
const str = '<h1>232</h1>';
这里输入内容
console.log(itheima.htmlstr(str));
"
## 还原html字符
"
const str = '<h1>232</h1>';
这里输入内容
console.log(itheima.htmlstr1(str));
"
"
文件里 有ceshi.js文件 可以在里面进行测试
"
## 开源协议
"
ISC
"

发布包

注册npm账号

• 登录npm网站，点击 sign up按钮，进入注册用户界面

• 填写账户相关的信息，Full Name , Public Email,  Username,  Password

• 点击Create an Account按钮，注册账号

在终端登录npm账号 

npm账号注册完成后，可以在终端中执行npm login命令，依次输入用户名，密码，邮箱后，即可登录成功。

注意：在登录npm包，发布包之前要将下载地址修改为npm官网地址，否则发布包会失败。

nrm use npm

登录

根据提示依次输入账号 密码 邮箱 验证码 

会显示已登录 后面显示网站名称

可以看到 我们登录到了官网上面

把包发布到npm上

将终端切换到 包的根目录 运行npm publish命令，就可以将包发不到npm上（注意 包不可以重名）

 发布成功  

打开网站  将账号登入 鼠标移动到头像  点击packages  就可以看到我们发布的内容

删除已发布的包

运行 这个命令就可以将npm上面的包删除掉

npm unpublish 包名--force

注意：通过此命令只可以删除发布72小时内的包

删除的包 24小时内不可以重复发布

更多node相关知识，请访问：nodejs 教程！