Nodejs四、npm与包

阿里云国内75折 回扣 微信号：monov8
阿里云国际，腾讯云国际，低至75折。AWS 93折 免费开户实名账号 代冲值 优惠多多 微信号：monov8 飞机：@monov6

零、文章目录

Nodejs四、npm与包

1、包

1包是什么

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

2包的来源

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

3为什么需要包

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

4从哪里下载包

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

5如何下载包

  • npm, Inc. 公司提供了一个包管理工具我们可以使用这个包管理工具从 https://registry.npmjs.org/ 服务器把需要的包下载到本地使用。
  • 这个包管理工具的名字叫做 Node Package Manager简称 npm 包管理工具这个包管理工具随着 Node.js 的安装包一起被安装到了用户的电脑上。
  • 大家可以在终端中执行 npm -v 命令来查看自己电脑上所安装的 npm 包管理工具的版本号
Microsoft Windows [版本 10.0.19045.2251]
(c) Microsoft Corporation。保留所有权利。

C:\Users\Administrator>npm -v
9.5.1

2、npm 初体验

1自己封装方式

  • 创建格式化时间的自定义模块

  • 定义格式化时间的方法

  • 创建补零函数

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

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

  • 调用格式化时间的函数

image-20230612104119447

2npm引入包方式

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

image-20230612104547402

3在项目中安装包的命令

  • 命令npm install 包名
  • 简化npm i 包名

4初次装包后多了哪些文件

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

5安装指定版本的包

  • npm install 包安装最新版本的包。
  • npm install 包@版本号安装指定版本的包例如npm install moment@2.22.2

6包的语义化版本规范

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

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

    • 第1位数字大版本

    • 第2位数字功能版本

    • 第3位数字Bug修复版本

3、包管理配置文件

1package.json

  • 在项目根目录中必须提供一个叫做 package.json 的包管理配置文件。用来记录与项目有关的一些配置信息。例如
    • 项目的名称、版本号、描述等
    • 项目中都用到了哪些包
    • 哪些包只在开发期间会用到
    • 那些包在开发和部署时都需要用到

2多人协作的问题

  • 问题第三方包的体积过大不方便团队成员之间共享项目源代码。
  • 解决方案共享时剔除node_modules添加到 .gitignore 忽略文件中。拿到项目后再根据package.json配置文件来还原包。包只在本地不上仓库。

3快速创建 package.json

  • 命令npm init -y
  • 说明命令只能在英文的目录下运行所以项目文件夹不要使用中文不能出现空格。
  • npm install 包名运行 npm install 命令安装包的时候npm 包管理工具会自动把包的名称和版本号记录到 package.json 中dependencies节点。
  • npm i 包名 -Dnpm install 包名 --save-dev如果某些包只在项目开发阶段用到上线之后不会用到则使用命令npm i 包名 -D把这些包记录到 devDependencies 节点中。

image-20230612133932474

4一次性安装所有的包

  • 当我们拿到一个剔除了 node_modules 的项目之后需要先把所有的包下载到项目中才能将项目运行起来否则找不到包报错。
  • 可以运行 npm install 命令或 npm i一次性安装所有的依赖包。

5卸载包

  • 可以运行 npm uninstall 命令来卸载指定的包比如npm uninstall moment
  • npm uninstall 命令执行成功后会把卸载的包自动从 package.json 的 dependencies 中移除掉。

4、解决下包速度慢的问题

1为什么下包速度慢

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

2淘宝 NPM 镜像服务器

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

image-20230612145220890

3切换npm 的下包镜像源

  • npm config get registry查看当前的下包镜像源
  • npm config set registry=https://registry.npm.taobao.org/将下包的镜修源切换为淘宝镜像源
  • npm config set registry=https://registry.npmjs.org/将下包的镜修源切换为官方镜像源

4nrm

  • 为了更方便的切换下包的镜像源我们可以安装 nrm 这个小工具利用 nrm 提供的终端命令可以快速查看和切换下包的镜像源。
  • npm i nrm -g通过npm包管理器将nrm安装为全局可用的工具
  • nrm ls查看所有可用的镜像源
  • nrm use taobao将下包的镜源切换为taobao镜像

5、包的分类

1项目包

  • 那些被安装到项目的 node_modules 目录中的包都是项目包。
  • 项目包又分为两类分别是
    • npm i 包名 -D开发依赖包被记录到 devDependencies 节点中的包只在开发期间会用到
    • npm i 包名核心依赖包被记录到 dependencies 节点中的包在开发期间和项目上线之后都会用到

2全局包

  • npm install 包名 -g在执行 npm install 命令时如果提供了 -g 参数则会把包安装为全局包。
  • 全局包会被安装到 C:\Users\用户目录\AppData\Roaming\npm\node_modules 目录下。
  • 只有工具性质的包才有全局安装的必要性。因为它们提供了好用的终端命令。判断某个包是否需要全局安装后才能使用可以参考官方提供的使用说明即可。

6、规范的包结构

  • 一个规范的包它的组成结构必须符合以下 3 点要求
    • 包必须以单独的目录而存在
    • 包的顶级目录下要必须包含 package.json 这个包管理配置文件
    • package.json 中必须包含 nameversionmain 这三个属性分别代表包的名字、版本号、包的入口。

7、开发自己的包

1初始化包的基本结构

  • 新建 lytestutils 文件夹作为包的根目录
  • 在 lytestutils 文件夹中新建如下三个文件
    • package.json 包管理配置文件
    • index.js 包的入口文件
    • README.md 包的说明文档

2package.json

  • 关于更多 license 许可协议相关的内容参考如图

5420598-95ed1ef9be4caf3f

{
  "name": "@bluecusliyou/lytestutils",
  "version": "1.1.1",
  "main": "index.js",
  "description": "提供了格式化时间、HTMLEscape相关的功能",
  "keywords": [
    "@bluecusliyou/lytestutils",
    "dateFormat",
    "escape"
  ],
  "license": "ISC"
}

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

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

4dateFormat.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
}

module.exports = {
  dateFormat
}

5htmlEscape.js

// 定义转义 HTML 字符的函数
function htmlEscape(htmlstr) {
  return htmlstr.replace(/<|>|"|&/g, match => {
    switch (match) {
      case '<':
        return '&lt;'
      case '>':
        return '&gt;'
      case '"':
        return '&quot;'
      case '&':
        return '&amp;'
    }
  })
}

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

module.exports = {
  htmlEscape,
  htmlUnEscape
}

6index.js

// 这是包的入口文件
const date = require('./src/dateFormat')
const escape = require('./src/htmlEscape')

// 向外暴露需要的成员
module.exports = {
  ...date,
  ...escape
}

7README.md

  • 包根目录中的 README.md 文件是包的使用说明文档。通过它我们可以事先把包的使用说明以 markdown 的格式写出来方便用户参考。
  • README内容没有强制性的要求我们的文档中包含以下内容安装方式、导入方式、格式化时间、转义 HTML 中的特殊字符、还原 HTML 中的特殊字符、开源协议
## 安装
```
npm install @bluecusliyou/lytestutils
```

## 导入
```js
const lytool = require('@bluecusliyou/lytestutils')
```

## 格式化时间
```js
// 调用 dateFormat 对时间进行格式化
const dtStr = lytool.dateFormat(new Date())
// 结果  2020-04-03 17:20:58
console.log(dtStr)
```

## 转义 HTML 中的特殊字符
```js
// 带转换的 HTML 字符串
const htmlStr = '<h1 title="abc">这是h1标签<span>123&nbsp;</span></h1>'
// 调用 htmlEscape 方法进行转换
const str = lytool.htmlEscape(htmlStr)
// 转换的结果 &lt;h1 title=&quot;abc&quot;&gt;这是h1标签&lt;span&gt;123&amp;nbsp;&lt;/span&gt;&lt;/h1&gt;
console.log(str)
```

## 还原 HTML 中的特殊字符
```js
// 待还原的 HTML 字符串
const str2 = lytool.htmlUnEscape(str)
// 输出的结果 <h1 title="abc">这是h1标签<span>123&nbsp;</span></h1>
console.log(str2)
```

## 开源协议
ISC

8、发布包

1注册 npm 账号

  • 访问 https://www.npmjs.com/ 网站点击 sign up 按钮进入注册用户界面
  • 填写账号相关的信息Full Name、Public Email、Username、Password
  • 点击 Create an Account 按钮注册账号
  • 登录邮箱点击验证链接进行账号的验证

2登录 npm 账号

  • npm 账号注册完成后可以在终端中执行 npm login 命令。
  • 在运行 npm login 命令之前必须先把下包的服务器地址切换为 npm 的官方服务器。否则会导致发布包失败
C:\Users\Administrator>npm login
npm notice Log in on https://registry.npmjs.org/
Login at:
https://www.npmjs.com/login?next=/login/cli/9f7115ed-dcac-4805-8dab-a22e72f9599d
Press ENTER to open in the browser...

Logged in on https://registry.npmjs.org/.

3把包发布到 npm 上

  • 先将终端切换到包的根目录注意路径不要有空格中文。
  • 运行 npm publish 命令即可将包发布到 npm 上注意包名不能雷同。

image-20230612171421626

4删除已发布的包

  • npm unpublish 包名 --force即可从 npm 删除已发布的包。
  • npm unpublish 命令只能删除 72 小时以内发布的包
  • npm unpublish 删除的包在 24 小时内不允许重复发布
  • 发布包的时候要慎重尽量不要往 npm 上发布没有意义的包
阿里云国内75折 回扣 微信号：monov8
阿里云国际，腾讯云国际，低至75折。AWS 93折 免费开户实名账号 代冲值 优惠多多 微信号：monov8 飞机：@monov6
标签: NodeJS
返回列表

上一篇：SpringCloud：分布式事务Seata事务模式

下一篇：C++学习——第二节课-输入输出

“Nodejs四、npm与包” 的相关文章

Nodejs geojson2geobuf1年前 (2023-02-02)
使用nvm实现nodejs版本管理(版本删除,版本切换,版本添加)1年前 (2023-02-08)
Nodejs原型链污染1年前 (2023-02-09)
nodejs学习笔记（六）—— Nodejs 中的fs(file system)模块 主要api1年前 (2023-03-09)
Nodejs 发送 TCP 消息的正确姿势1年前 (2023-03-10)
NodeJS 实战系列：模块设计与文件分类1年前 (2023-03-24)
Docker部署Golang+Gin和Python+Tornado后端和NodeJS+Web框架1年前 (2023-04-09)
使用Nodejs搭建HTTP服务，并实现公网远程访问「内网穿透」1年前 (2023-04-23)
nodejs的下载安装1年前 (2023-04-25)
安装nvm，并使用nvm安装nodejs及配置环境变量1年前 (2023-04-27)

阿里云国际版