npm包管理工具；package.json；package-lock.json；npm install安装和原理；yarn、cnpm、npx；npm发布包；pnpm

1_npm包管理工具

1.1_代码共享方案

在JavaScript中可以通过模块化的方式将代码划分成一个个小的结构：

• 在以后的开发中就可以通过模块化的方式来封装自己的代码，并且封装成一个工具；
• 这个工具可以让同事通过导入的方式来使用，甚至可以分享给世界各地的程序员来使用；

如果分享给世界上所有的程序员使用，有哪些方式呢？

方式一：上传到GitHub上、其他程序员通过GitHub下载的代码手动的引用；

• 缺点是大家必须知道的代码GitHub的地址，并且从GitHub上手动下载；
• 需要在自己的项目中手动的引用，并且管理相关的依赖；
• 不需要使用的时候，需要手动来删除相关的依赖；
• 当遇到版本升级或者切换时，需要重复上面的操作；

显然，上面的方式是有效的，但是这种传统的方式非常麻烦，并且容易出错；

方式二：使用一个专业的工具来管理的代码

• 通过工具将代码发布到特定的位置；
• 其他程序员直接通过工具来安装、升级、删除的工具代码；

显然，通过第二种方式可以更好的管理自己的工具包，其他人也可以更好的使用的工具包

1.2_包管理工具npm

包管理工具npm：

• Node Package Manager，也就是Node包管理器；
• 但是目前已经不仅仅是Node包管理器了，在前端项目中也在使用它来管理依赖的包；
• 比如vue、vue-router、vuex、express、koa、react、react-dom、axios、babel、webpack等等；

如何下载和安装npm工具呢？

• npm属于node的一个管理工具，所以需要先安装Node；
• node管理工具：https://nodejs.org/en/，安装Node的过程会自动安装npm工具；

npm管理的包可以在哪里查看、搜索呢？

• https://www.npmjs.org/
• 这是安装相关的npm包的官网；

npm管理的包存放在哪里呢？

• 发布自己的包其实是发布到registry上面的；
• 当安装一个包时其实是从registry上面下载的包；

2_package.json

对于一个项目来说，如何使用npm来管理这么多包呢？

• 事实上，每一个项目都会有一个对应的配置文件，无论是前端项目（Vue、React）还是后端项目（Node）；
• 这个配置文件会记录着项目的名称、版本号、项目描述等；
• 也会记录着项目所依赖的其他库的信息和依赖库的版本号；

这个配置文件就是package.json

那么这个配置文件如何得到呢？

• 方式一：手动从零创建项目，npm init –y
• 方式二：通过脚手架创建项目，脚手架会帮助生成package.json，并且里面有相关的配置

2.1_配置文件中常见的属性

必须填写的属性：name、version

• name是项目的名称；
• version是当前项目的版本号；
• description是描述信息，很多时候是作为项目的基本描述；
• author是作者相关信息（发布时用到）；
• license是开源协议（发布时用到）；

private属性：

• private属性记录当前的项目是否是私有的；
• 当值为true时，npm是不能发布它的，这是防止私有项目或模块发布出去的方式；

scripts属性

• scripts属性用于配置一些脚本命令，以键值对的形式存在；
• 配置后可以通过 npm run 命令的key来执行这个命令；
• npm start和npm run start的区别是什么？
  • 它们是等价的；
  • 对于常用的 start、 test、stop、restart可以省略掉run直接通过 npm start等方式运行；

dependencies属性

• dependencies属性是指定无论开发环境还是生成环境都需要依赖的包；
• 相当于记录一个项目所依赖的包，届时可以删除包文件，通过npm install又能重新下载所需的包；
• 通常是项目实际开发用到的一些库模块vue、vuex、vue-router、react、react-dom、axios等等；
• 与之对应的是devDependencies；

devDependencies属性

• 一些包在生成环境是不需要的，比如webpack、babel等；
• 这个时候会通过 npm install webpack --save-dev，将它安装到devDependencies属性中；

peerDependencies属性

• 还有一种项目依赖关系是对等依赖，也就是依赖的一个包，它必须是以另外一个宿主包为前提的；
• 比如element-plus是依赖于vue3的，ant design是依赖于react、react-dom；

engines属性

• engines属性用于指定Node和NPM的版本号；
• 在安装的过程中，会先检查对应的引擎版本，如果不符合就会报错；
• 事实上也可以指定所在的操作系统 “os” : [ “darwin”, “linux” ]，只是很少用到；

browserslist属性

• 用于配置打包后的JavaScript浏览器的兼容情况，参考；
• 否则需要手动的添加polyfills来让支持某些语法；
• 也就是说它是为webpack等打包工具服务的一个属性（这里不是详细讲解webpack等工具的工作原理，所以不再给出详情）；

2.2_依赖的版本管理

安装的依赖版本出现：^2.0.3或~2.0.3，这是什么意思呢？

npm的包通常需要遵从semver版本规范：

• semver：https://semver.org/lang/zh-CN/
• npm semver：https://docs.npmjs.com/misc/semver

semver版本规范是X.Y.Z：

• X主版本号（major）：当做了不兼容的 API 修改（可能不兼容之前的版本）；
• Y次版本号（minor）：当做了向下兼容的功能性新增（新功能增加，但是兼容之前的版本）；
• Z修订号（patch）：当做了向下兼容的问题修正（没有新功能，修复了之前版本的bug）；

^和~的区别：

• x.y.z：表示一个明确的版本号；
• ^x.y.z：表示x是保持不变的，y和z永远安装最新的版本；
• ~x.y.z：表示x和y保持不变的，z永远安装最新的版本；

3_npm install

3.1_命令

安装npm包分两种情况：

• 全局安装（global install）： npm install webpack -g;
• 项目（局部）安装（local install）： npm install webpack

全局安装

• 全局安装是直接将某个包安装到全局：
• 比如全局安装yarn：

但是很多人对全局安装有一些误会：

• 通常使用npm全局安装的包都是一些工具包：yarn、webpack等；
• 并不是类似于 axios、express、koa等库文件；
• 所以全局安装了之后并不能让在所有的项目中使用 axios等库；

3.2_项目安装

项目安装会在当前目录下生成一个 node_modules 文件夹，之前讲解require查找顺序时有讲解过这个包在什么情况下被查找；

局部安装分为开发时依赖和生产时依赖：

默认安装开发和生产依赖
npm install axios
npm i axios

开发依赖
npm install webpack --save-dev
npm install webpack -D
npm i webpack –D

根据package.json中的依赖包
npm install

3.3_原理

提出疑问？

• 执行 npm install它背后完成了什么操作？
• package-lock.json的文件，它的作用是什么？
• 从npm5开始，npm支持缓存策略（来自yarn的压力），缓存有什么作用？

npm install会检测是有package-lock.json文件：

• 没有lock文件
  • 分析依赖关系，这是因为可能包会依赖其他的包，并且多个包之间会产生相同依赖的情况；
  • 从registry仓库中下载压缩包（如果设置了镜像，那么会从镜像服务器下载压缩包）；
  • 获取到压缩包后会对压缩包进行缓存（从npm5开始有的）；
  • 将压缩包解压到项目的node_modules文件夹中（前面讲过，require的查找顺序会在该包下面查找）
• 有lock文件
  • 检测lock中包的版本是否和package.json中一致（会按照semver版本规范检测）。
    • 不一致，那么会重新构建依赖关系，直接会走顶层的流程；
    • 一致的情况下，会去优先查找缓存。 没有找到，会从registry仓库下载，直接走顶层流程；
  • 查找到缓存，会获取 缓存中的压缩文件，并且将压缩文件解压到node_modules文件夹中；

3.4_package-lock.json

文件解析：

• name：项目的名称；
• version：项目的版本；
• lockfileVersion：lock文件的版本；
• requires：使用requires来跟踪模块的依赖关系；
• dependencies：项目的依赖
  • 当前项目依赖axios，但是axios依赖follow-redireacts；
  • axios中的属性如下：
    • version表示实际安装的axios的版本；
    • resolved用来记录下载的地址，registry仓库中的位置；
    • requires/dependencies记录当前模块的依赖；
    • integrity用来从缓存中获取索引，再通过索引去获取压缩包文件；

3.5_npm其他命令

卸载某个依赖包
npm uninstall package
npm uninstall package --save-dev
npm uninstall package -D

强制重新build ：npm rebuild

清除缓存 : npm cache clean

npm的命令非常多, 更多的命令，可以根据需要查阅官方文档 https://docs.npmjs.com/cli-documentation/cli

4_yarn、cnpm、npx

4.1_ yarn

node包管理工具yarn：

• yarn是由Facebook、Google、Exponent 和 Tilde 联合推出了一个新的 JS 包管理工具；
• yarn 是为了弥补 早期npm 的一些缺陷而出现的；
• 早期的npm存在很多的缺陷，比如安装依赖速度很慢、版本依赖混乱等等一系列的问题；
• 虽然从npm5版本开始，进行了很多的升级和改进，但是依然很多人喜欢使用yarn；

4.2_cnpm

由于一些特殊的原因，某些情况下没办法很好的从 https://registry.npmjs.org 下载下来一些需要的包。

查看npm镜像：npm config get registry

设置npm的镜像：npm config set registry https://registry.npm.taobao.org

但是对于大多数人来说，并不希望将npm镜像修改了：

• 第一，不太希望随意修改npm原本从官方下来包的渠道；
• 第二，担心某天淘宝的镜像挂了或者不维护了，又要改来改去；
  这个时候，可以使用cnpm，并且将cnpm设置为淘宝的镜像：

cnpm工具

npm install -g cnpm --registry=https://registry.npm.taobao.org
cnpm config get registry # https://r.npm.taobao.org/

4.3_npx

npx是npm5.2之后自带的一个命令。 npx的作用非常多，但是比较常见的是使用它来调用项目中的某个模块的指令。

以webpack为例：

• 全局安装的是webpack5.1.3
• 项目安装的是webpack3.6.0

如果在终端执行 webpack --version使用的是哪一个命令呢？

• 显示结果会是 webpack 5.1.3，事实上使用的是全局的，为什么呢？
• 原因非常简单，在当前目录下找不到webpack时，就会去全局找，并且执行命令；

局部命令的执行

使用项目（局部）的webpack的方式：

（1） 方式一：在终端中使用如下命令
首先切换到./node_modules/.bin/目录下，然后终端输入webpack --version

（2） 方式二：修改package.json中的scripts
“scripts”: {
“build”: "webpack "
}

然后在终端输入命令 npm run build

（3）方式三：使用npx。终端输入npx webpack --version

npx的原理非常简单，它会到当前目录的node_modules/.bin目录下查找对应的命令；

5_npm发布自己的包

注册npm账号：到官网 https://www.npmjs.com/ 选择sign up注册

在命令行登录：npm login

修改package.json

发布到npm registry上：npm publish

更新仓库：修改版本号(最好符合semver规范)； 重新发布

删除发布的包：npm unpublish

让发布的包过期：npm deprecate

6_pnpm

6.1_简介

访问官网 https://www.pnpm.cn/
官网介绍：

• 快速：pnpm 是同类工具速度的将近 2 倍

• 高效：node_modules 中的所有文件均克隆或硬链接自单一存储位置

• 支持单体仓库：pnpm 内置了对单个源码仓库中包含多个软件包的支持

• 权限严格：pnpm 创建的 node_modules 默认并非扁平结构，因此代码无法对任意软件包进行访问

包括Vue在内的很多公司或者开源项目的包管理工具都切换到了pnpm；

6.2_硬链接和软连接

硬链接（hard link）：

• 硬链接（英语：hard link）是电脑文件系统中的多个文件平等地共享同一个文件存储单元；
• 删除一个文件名字后，还可以用其它名字继续访问该文件；

符号链接（软链接soft link、Symbolic link）：（可以理解为快捷方式）

• 符号链接（软链接、Symbolic link）是一类特殊的文件；
• 其包含有一条以绝对路径或者相对路径的形式指向其它文件或者目录的引用

6.3_pnpm的作用

当使用 npm 或 Yarn 时，如果有 100 个项目，并且所有项目都有一个相同的依赖包，那么， 在硬盘上就需要保存 100 份该相同依赖包的副本。

如果是使用 pnpm，依赖包将被 存放在一个统一的位置，因此：

• 如果对同一依赖包使用相同的版本，那么磁盘上只有这个依赖包的一份文件；
• 如果对同一依赖包需要使用不同的版本，则仅有 版本之间不同的文件会被存储起来；
• 所有文件都保存在硬盘上的统一的位置：
  • 当安装软件包时， 其包含的所有文件都会硬链接到此位置，而不会占用 额外的硬盘空间；
  • 这让可以在项目之间方便地共享相同版本的 依赖包；

6.4_pnpm创建非扁平的 node_modules 目录

当使用 npm 或 Yarn Classic 安装依赖包时，所有软件包都将被提升到 node_modules 的 根目录下。其结果是，源码可以访问 本不属于当前项目所设定的依赖包；

详细的实现略过，记住上面的结论即可。

6.5_pnpm的安装和使用

安装pnpm？

• 官网提供了很多种方式来安装pnpm：https://www.pnpm.cn/installation

• 若安装过Node，Node中有npm，通过npm安装即可；

使用npm ： npm install -g pnpm

更多命令和用法可以参考pnpm的官网：https://pnpm.io/zh/

6.6_pnpm的存储store

在pnpm7.0之前，统一的存储位置是 ~/.pnpm-score中的；

在pnpm7.0之后，统一的存储位置进行了更改：/store

• 在 Linux 上，默认是 ~/.local/share/pnpm/store
• 在 Windows 上： %LOCALAPPDATA%/pnpm/store
• 在 macOS 上： ~/Library/pnpm/store

终端命令获取当前活跃的store目录 ：pnpm store path

prune命令从store中删除当前未被引用的包来释放store的空间 ：pnpm store prune

90765009324)]

更多命令和用法可以参考pnpm的官网：https://pnpm.io/zh/