一文詳解Node.js中的npm與包【萬字教學】-js教程-PHP中文網

//定义格式化时间的方法
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 : &#39;0&#39; + data;
}
//暴露对象
module.exports = { dataFormat };

登入後複製

大家注意要曝光這裡要用module.exports，因為這裡引用了新的對象，或修改引用物件新增屬性，可以使用exports。

exports.dataFormat = dataFormat;

登入後複製

使用模組

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

登入後複製

##利用套件格式化時間

# 步驟

在目前終端機中輸入

npm install moment

登入後複製

npm 包管理工具
install 安装可简写成 i
moment 包名称

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

实现代码

//导入包
const moment = require(&#39;moment&#39;);
//格式化事件
//单词要大写
const newdate = moment().format(&#39;YYYY-MM-DD HH:MM:SS&#39;);
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的下包镜像源

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

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 : &#39;0&#39; + data;
}
//暴露对象
exports.dataFormat = dataFormat;

登入後複製

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

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

                return &#39;&lt;&#39;;

            case &#39;>&#39;:
                return &#39;&gt;&#39;;
            case &#39;"&#39;:
                return &#39;&quot;&#39;;
            case &#39;&&#39;:
                return &#39;&amp;&#39;;
        }
    })
}
//暴露对象
exports.htmlstr = htmlstr;

登入後複製

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

function htmlstr1(hstr) {
    return hstr.replace(/&lt;|&gt;|&quot;|&amp;/g, data => {
        switch (data) {
            case &#39;&lt;&#39;:

                return &#39;<&#39;;

            case &#39;&gt;&#39;:
                return &#39;>&#39;;
            case &#39;&quot;&#39;:
                return &#39;"&#39;;
            case &#39;&amp;&#39;:
                return &#39;&&#39;;
        }
    })
}
//暴露对象
exports.htmlstr1 = htmlstr1;

登入後複製

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

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

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

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

const htmlstr = require(&#39;./src/htmlstr&#39;);
const dataFormat = require(&#39;./src/dataFormat&#39;);



module.exports = {
    htmlstr,
    dataFormat
}

登入後複製

调用测试

const itheima = require(&#39;../itheima-tools&#39;);

console.log(itheima.dataFormat.dataFormat(new Date()));
const str = &#39;<h1>232</h1>&#39;;
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(&#39;./src/htmlstr&#39;);
const dataFormat = require(&#39;./src/dataFormat&#39;);



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

登入後複製

ceshi.js

const itheima = require(&#39;../itheima-tools&#39;);

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

登入後複製

编写包的说明文档

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

安装方式
导入方式
格式化时间
转义html中的特殊字符
还原html中的特殊字符
开源协议

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

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

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

登入後複製