7、Node.js---包管理工具

新新程序名媛

已于 2023-03-29 16:34:41 修改

阅读量969

点赞数 1

分类专栏： Node.js 文章标签： node.js

于 2023-03-28 13:40:27 首次发布

本文链接：https://blog.csdn.net/Ezzbb/article/details/129812704

版权

Node.js 专栏收录该内容

12 篇文章 1 订阅

订阅专栏

4、require 导入 npm 包基本流程

（一）什么是包管理工具

1、包是什么

『包』英文单词是 package ，代表了一组特定功能的源码集合

2、包管理工具

管理『包』的应用软件，可以对「包」进行下载安装，更新，删除，上传等操作借助包管理工具，可以快速开发项目，提升开发效率。包管理工具是一个通用的概念，很多编程语言都有包管理工具，所以掌握好包管理工具非常重要

3、常用的包管理工具

npm

yarn

cnpm

（二）npm

1、什么是npm

npm 全称 Node Package Manager ，翻译为中文意思是『Node 的包管理工具』

npm 是 node.js 官方内置的包管理工具，是必须要掌握住的工具

2、npm 的安装

node.js 在安装时会自动安装 npm ，所以如果你已经安装了 node.js ，可以直接使用 npm

可以通过 npm - v 查看版本号测试，如果显示版本号说明安装成功，反之安装失败

命令：npm -v

（三）npm初始化一个包

1、初始化

创建一个空目录，然后以此目录作为工作目录启动命令行工具，执行 npm init

成功！

npm init 命令的作用是将文件夹初始化为一个『包』，交互式创建 package.json 文件

package.json 是包的配置文件，每个包都必须要有 package.json

package.json 内容示例：

属性翻译

{
"name": "1-npm", #包的名字
"version": "1.0.0", #包的版本
"description": "", #包的描述
"main": "index.js", #包的入口文件
"scripts": { #脚本配置
"test": "echo \"Error: no test specified\" && exit 1"
},
"author": "", #作者
"license": "ISC" #开源证书
}

注意事项：

初始化的过程中还有一些注意事项：

1. package name ( 包名 ) 不能使用中文、大写，默认值是文件夹的名称，所以文件夹名称也不

能使用中文和大写

2. version ( 版本号 ) 要求 x.x.x 的形式定义， x 必须是数字，默认值是 1.0.0

3. ISC 证书与 MIT 证书功能上是相同的，关于开源证书扩展阅读

如何选择开源许可证？ - 阮一峰的网络日志

4. package.json 可以手动创建与修改

5. 使用 npm init -y 或者 npm init --yes 极速创建 package.json

2、搜索包

两种方式：

1. 命令行『npm s/search 关键字』

2. 网站搜索网址是 https://www.npmjs.com/

小贴士：如何知道什么场景用什么包？

在网站上搜索自己想要的包

多看别人的项目，下载了什么包，积累

3、下载安装包

npm install 和 npm i 命令安装包

# 格式

npm install < 包名 >

npm i < 包名 >

# 示例

npm install uniq

npm i uniq

注意：下载包是要联网状态！

运行之后文件夹下会增加两个资源

node_modules 文件夹存放下载的包

package-lock.json 包的锁文件，用来锁定包的版本

安装 uniq 之后， uniq 就是当前这个包的一个依赖包，有时会简称为依赖

比如我们创建一个包名字为 A ， A 中安装了包名字是 B ，我们就说 B 是 A 的一个依赖包，也会说

A 依赖 B

使用：

const fs=require('uniq');

用法可以看官网下载包的介绍

4、require 导入 npm 包基本流程

1. 在当前文件夹下 node_modules 中寻找同名的文件夹

2. 在上级目录中下的 node_modules 中寻找同名的文件夹，直至找到磁盘根目录

const fs=require('uniq');

导的是node_modules文件夹下的uniq包

5、开发依赖与生产依赖

1、生产环境与开发环境

开发环境是程序员专门用来写代码的环境，一般是指程序员的电脑，开发环境的项目一般只能程序员自己访问

生产环境是项目代码正式运行的环境，一般是指正式的服务器电脑，生产环境的项目一般每个客户都可以访问

2、生产依赖与开发依赖

我们可以在安装时设置选项来区分依赖的类型，目前分为两类：

类型	命令	补充
生产依赖	npm i -S uniq npm i --save uniq	-S 等效于 --save ， - S 是默认选项包信息保存在 package.json 中 dependencies 属性
开发依赖	npm i -D less npm i --save-dev less	-D 等效于 --save-dev 包信息保存在 package.json 中 devDependencies 属性

生产依赖dependencies：指这个依赖既在开发阶段使用，又在最终的运行阶段使用。

开发依赖devDependencies：只在开发阶段使用，过了开发阶段就没用了。

举个例子方便大家理解，比如说做蛋炒饭需要大米，油，葱，鸡蛋，锅，煤气，铲子等

其中锅，煤气，铲子属于开发依赖，只在制作阶段使用

而大米，油，葱，鸡蛋属于生产依赖，在制作与最终食用都会用到

所以开发依赖是只在开发阶段使用的依赖包，而生产依赖是开发阶段和最终上线运行阶段都用到

的依赖包

注意：

安装时选生产依赖还是开发依赖：看开发文档会有标识，或者自己判断。

6、npm全局安装

npm i -g nodemon

全局安装完成之后就可以在命令行的任何位置运行 nodemon 命令

该命令的作用是自动重启 node 应用程序

运行：nodemon 文件名（nodemon 01.js）

修改文件后保存，他会自动重启node应用程序，自动更新。

说明：

全局安装的命令不受工作目录位置影响

可以通过 npm root - g 可以查看全局安装包的位置

不是所有的包都适合全局安装，只有全局类的工具才适合，可以通过查看包的官方文档来确定

安装方式，这里先不必太纠结

7、修改 windows 执行策略

若出现这种错误：

windows 默认不允许 npm 全局命令执行脚本文件，所以需要修改执行策略

1. 以管理员身份打开 powershell 命令行

2. 键入命令 set-ExecutionPolicy remoteSigned

3. 键入 A 然后敲回车

4. 如果不生效，可以尝试重启 vscode

8、环境变量 Path

Path 是操作系统的一个环境变量，可以设置一些文件夹的路径，在当前工作目录下找不到可执行文件时，就会在环境变量 Path 的目录中挨个的查找，如果找到则执行，如果没有找到就会报错

补充说明：

1、如果希望某个程序在任何工作目录下都能正常运行，就应该将该程序的所在目录配置到环境变量 Path 中

2、windows 下查找命令的所在位置

cmd 命令行中执行 where nodemon

powershell命令行执行 get - command nodemon

9、npm安装包的所有依赖

在项目协作中有一个常用的命令就是 npm i ，通过该命令可以依据 package.json 和 package

lock.json 的依赖声明安装项目依赖

npm i

npm install

在拿到一个新项目时，第一步要做的就是这个导入所有包。

node_modules 文件夹大多数情况都不会存入版本库

10、npm安装指定版本包与删除包

命令：

npm i < 包名 @ 版本号 >

## 示例

npm i jquery@1.11.2

删除包：

命令：

## 局部删除

npm remove uniq

npm r uniq

## 全局删除

npm remove -g nodemon

11、npm配置命令别名

通过配置命令别名可以更简单的执行命令

配置 package.json 中的 scripts 属性

{
.
.
.
"scripts": {
"server": "node server.js",
"start": "node index.js",
},
.
.
}

配置完成之后，可以使用别名执行命令

npm run server

npm run start

不过 start 别名比较特别，使用时可以省略 run

npm start

补充说明：

npm start 是项目中常用的一个命令，一般用来启动项目

npm run 有自动向上级目录查找的特性，跟 require 函数也一样

对于陌生的项目，我们可以通过查看 scripts 属性来参考项目的一些操作

（四）cnpm

1、介绍

cnpm 是一个淘宝构建的 npmjs.com 的完整镜像，也称为『淘宝镜像』，网址 https://npmmirror.com/

cnpm 服务部署在国内阿里云服务器上，可以提高包的下载速度

官方也提供了一个全局工具包 cnpm ，操作命令与 npm 大体相同

2、安装

npm install -g cnpm --registry = https://registry.npmmirror.com

3、操作命令

功能	命令
初始化	cnpm init / cnpm init
安装包	cnpm i uniq cnpm i -S uniq cnpm i -D uniq cnpm i -g nodemon
安装项目依赖	cnpm i
删除	cnpm r uniq

4、npm 配置淘宝镜像

用 npm 也可以使用淘宝镜像，配置的方式有两种

直接配置

npm config set registry https://registry.npmmirror.com/

2、工具配置（推荐）

使用 nrm 配置 npm 的镜像地址 npm registry manager

2.1安装 nrm

npm i -g nrm

2.2修改镜像

nrm use taobao

2.3检查是否配置成功（选做）

npm config list

检查 registry 地址是否为 https://registry.npmmirror.com/ , 如果是则表明成功

补充说明：

1. 建议使用第二种方式进行镜像配置，因为后续修改起来会比较方便

2. 虽然 cnpm 可以提高速度，但是 npm 也可以通过淘宝镜像进行加速，所以 npm 的使用率还

是高于 cnpm

（五）yarn

yarn 是由 Facebook 在 2016 年推出的新的 Javascript 包管理工具，官方网址： https://yarnpkg.com/

1、yarn的特点：

yarn 官方宣称的一些特点

速度超快：yarn 缓存了每个下载过的包，所以再次使用时无需重复下载。同时利用并行下载以最大

化资源利用率，因此安装速度更快

超级安全：在执行代码之前，yarn 会通过算法校验每个安装包的完整性

超级可靠：使用详细、简洁的锁文件格式和明确的安装算法，yarn 能够保证在不同系统上无差异的工作

2、yarn 安装

npm i -g yarn 全局安装

3、yarn 常用命令

功能	命令
初始化	yarn init / yarn init -y
安装包	yarn add uniq 生产依赖 yarn add less --dev 开发依赖 yarn global add nodemon 全局安装
删除包	yarn remove uniq 删除项目依赖包 yarn global remove nodemon 全局删除包
安装项目依赖	yarn
运行命令别名	yarn < 别名 > # 不需要添加 run

思考题：

这里有个小问题就是全局安装的包不可用， yarn 全局安装包的位置可以通过 yarn global bin

来查看，

那你有没有办法使 yarn 全局安装的包能够正常运行？

yarn的全局安装不好使，需要手动将yarn的全局安装命令配置到环境变量path中。

4、yarn 配置淘宝镜像

yarn config set registry https://registry.npmmirror.com/

可以通过 yarn config list 查看 yarn 的配置项

5、npm 和 yarn 选择

大家可以根据不同的场景进行选择

1. 个人项目

如果是个人项目，哪个工具都可以，可以根据自己的喜好来选择

2. 公司项目

如果是公司要根据项目代码来选择，可以通过锁文件判断项目的包管理工具

npm 的锁文件为 package - lock.json

yarn 的锁文件为 yarn.lock

包管理工具不要混着用，切记，切记，切记

（六）管理发布包

1、创建与发布

我们可以将自己开发的工具包发布到 npm 服务上，方便自己和其他开发者使用，操作步骤如下：

1. 创建文件夹，并创建文件 index.js ，在文件中声明函数，使用 module.exports 暴露

2. npm 初始化工具包， package.json 填写包的信息 ( 包的名字是唯一的 )

3. 注册账号 https://www.npmjs.com/signup

4. 激活账号（一定要激活账号）

5. 修改为官方的官方镜像 ( 命令行中运行 nrm use npm )

6. 命令行下 npm login 填写相关用户信息

7. 命令行下 npm publish 提交包 👌

实践：

1、先创建一个文件夹，进入包文件

2、初始化

npm init

注意：包的名字不能乱去，官方会有检测垃圾包的功能,不能起test之类的名字。

创建完成！

3、新建一个文件index.js（改要一起改）

4、写基本功能（例子）

5、注册npm账号

https://www.npmjs.com/signup

6、激活账号

7、修改为官方的官方镜像 (命令行中运行 nrm use npm )

这一步一定要做！

8、命令行下 npm login 填写相关用户信息

9、发布：命令行下 npm publish 提交包 👌

10、使用自己创建的包

完成！

2、npm包的更新与删除

更新包：

后续可以对自己发布的包进行更新，操作步骤如下

1. 更新包中的代码

2. 测试代码是否可用

新建一个test.js文件

3. 修改 package.json 中的版本号

4. 发布更新 npm publish

删除包：

npm unpublish --force

删除包需要满足一定的条件， https://docs.npmjs.com/policies/unpublish

你是包的作者
发布小于 24 小时
大于 24 小时后，没有其他包依赖，并且每周小于 300 下载量，并且只有一个维护者

（七）扩展

在很多语言中都有包管理工具，比如：

语言	包管理工具
PHP	composer
Python	pip
Java	maven
Go	ho mod
JavaScript	npm/yarn/cnpm/other
Ruby	rubyGems

除了编程语言领域有包管理工具之外，操作系统层面也存在包管理工具，不过这个包指的是『软件包』

操作系统	包管理工具	网址
Centos	yum	https://packages.debian.org/stable/
Ubuntu	apt	https://packages.ubuntu.com/
MacOS	homebrew	https://brew.sh/
Windows	chocolatey	https://chocolatey.org/

（八）nvm

nvm 全称 Node Version Manager 顾名思义它是用来管理 node 版本的工具，方便切换不同版本的

Node.js

1、使用

nvm 的使用非常的简单，跟 npm 的使用方法类似

下载安装

首先先下载 nvm，下载地址 https://github.com/coreybutler/nvm-windows/releases，

选择 nvm - setup.exe 下载即可（网络异常的小朋友可以在资料文件夹中获取）

2、常用命令

命令	说明
nvm list available	显示所有可以下载的 Node.js 版本
nvm list	显示已安装的版本
nvm install 18.12.1	安装 18.12.1 版本的 Node.js
nvm install latest	安装最新版的 Node.js
nvm uninstall 18.12.1	删除某个版本的 Node.js
nvm use 18.12.1	切换 18.12.1 的 Node.js