2024-05-26 包管理工具使用

1、代码共享方案

• 我们已经学习了在JavaScript中可以通过模块化的方式将代码划分成一个个小的结构：

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

• 我们我们分享给世界上所以得程序员使用，有哪些方式呢？
• 方式一：上传到GitHub上，其他程序员通过GitHub下载我们的代码手动的引用；

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

• 显然，上面的方式是有效的，但是这种传统的方式非常麻烦，并且容易出错；
• 方式二：使用一个专业的工具来管理我们的代码

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

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管理工具：Node官网，安装Node的过程会自动安装npm工具；

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

• 这是我们安装相关的npm包的官网：npm官网；

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

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

3、npm的配置文件

• 那么对应一个项目来说，我们如何使用npm来管理那么多包呢？

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

• 这个配置文件就是package.json
• 那么这个配置文件如何得到呢？

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

3.1、常见的配置文件

3.2、配置文件中常见的属性

• 必须填写的属性：name、version

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

• private属性：

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

• main属性：

• 设置程序的入口。
  √ 比如我们使用axios模块 const axios = require(‘axios’)；
  √ 如果有main属性，实际上是找到对应的main属性来查找文件的（根据require查找规则，默认查找index.js，通过main属性我们可以把入口文件的名称设置成任何我们想要的名字）；
  

• scripts属性

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

• dependencies属性

• dependencies属性是指定无论开发环境还是生产环境都需要依赖的包；
• 通常是我们项目实际开发用到的一个库模块vue、vuex、vue-router、react、react-dom、axios等等；
• 与之对应的是devDependencies；

• devDependencies属性

• 一些包在生产环境是不需要的，比如webpack、babel等；
• 这个时候我们会通过 npm install webpack --save-dev（–save-dev可以简写成-D），将它安装到devDependencies属性中；

• peerDependencies属性

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

• engines属性

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

• browserslist属性

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

3.3、依赖的版本管理

• 我们会发现安装的依赖版本出现：^2.0.3或~2.0.3，这是什么意思呢？
• npm的包通常需要遵从semver版本规范：

• semver：semver.org
• npm semver：About semantic versioning

• 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永远安装最新的版本；

4、npm install命令

4.1、全局安装

npm install webpack -g

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

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

5、package-lock.json文件解析

• name：项目名称；
• version：项目的版本；
• lockfileVersion：lock文件的版本；
• requires：使用requires来跟踪模块的依赖关系；
• dependencies：项目的依赖

• 当前项目依赖axios，但是axios依赖follow-redireacts；
• axios中的属性如下：
  √ version表示实际安装的axios版本；
  √ resolved用来记录下载的地址，registry仓库中的位置；
  √ requires/dependencies记录当前模块的依赖（当上面的requires值为true时，这里的属性名既可以写成requires也可以写成dependencies；不然只能够写成dependencies）；
  √ integrity用来从缓存中获取索引，再通过索引去获取压缩包文件；

6、 npm install 原理

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

• 没有lock文件

• 分析依赖关系，这是因为我们的依赖包可能也会依赖其他的包，并且多个包之间会产生相同的依赖的情况；
• 从registry仓库中下载压缩包（如果我们设置了镜像，那么会从镜像服务器下载压缩包）；
• 获取到压缩包后会对压缩包进行缓存（从npm5开始有的）；
• 将压缩包解压到项目的node_modules文件夹中（前面我们讲过，require的查找顺序会在该文件夹下面查找）；

• 有lock文件

• 检测lock中包的版本是否和package.json中一致（会按照semver版本规范检测）；
  √ 不一致，那么会重新构建依赖关系
• 一致的情况下，会去优先查找缓存
  √ 没有找到，会从registry仓库下载
  √ 查找到，会获取缓存中的压缩文件，并且将压缩文件解压到node_modules文件夹中；

7、npm 其他命令

我们这里再介绍几个比较常用的：

• 卸载某个依赖包：

npm uninstall <package>
npm uninstall <package> --save-dev
npm uninstall <package> -D

• 强制重新build（强制根据package.json里面的版本去下载最新依赖包，而不是根据lock文件去下载，也就是当成没有lock文件的情况去下载）：

npm rebuild

• 清除缓存：

npm cache clean

• npm的命令其实是非常多的：

更多的命令，可以根据需要查阅官方文档：CLI Commands

8、yarn工具

yarn工具是另一个node包管理工具。

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

下面列举了npm跟yarn之间相同功能命令间的对比：

9、cnpm工具

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

# 查看npm镜像
npm config get registry
# 我们可以直接设置npm的镜像
npm config set registry https://registry.npm.taobao.org

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

• 第一，不太希望随意修改npm原本从官方下载包的渠道；
• 第二，担心某天淘宝的镜像挂了或者不维护了，又要改来改去；

• 这个时候，我们可以使用cnpm，并且将cnpm设置为淘宝的镜像：

# 安装cnpm并设置cnpm对应的镜像地址（如果这条命令执行不成功的话，可以分成两条命令各自执行）
npm install -g cnpm --registry=https://registry.npm.taobao.org
# 查看cnpm镜像地址
cnpm config get registry

10、npx工具

• npx是npm5.2之后自带的一个命令。

• npx的作用非常多，但是比较常见的是使用它来调用项目中的某个模块的指令。

• 我们以yarn为例：

• 全局安装的是yarn1.19.1
• 项目安装的是yarn1.22.22

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

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

• 那么如何使用项目（局部）的yarn，常见的是两种方式：

• 方式一：明确查找到node_modules下面的yarn
• 方式二：在scripts定义脚本，来执行yarn；

• 方式一：在终端中使用如下命令（在项目根目录下）

# windows系统下可能并不兼容这种写法，需要我们自己手动cd到.bin目录下后再执行yarn --version命令
./node_modules/.bin/yarn --version

• 方式二：修改package.json中的scripts

"scripts": {
    "yarn": "yarn --version"
  }

npm run yarn

• 方式三：使用npx

npm yarn --version

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

11、npm发布自己的包

• 注册npm账号

• npm官网首页
• 选择sign up

• 在命令行登录：

npm login

• 修改package.json
• 发布到npm registry上

npm publish

• 更新仓库

1. 修改package.json中的版本号（最好符合semver规范）
2. 重新执行发布

• 删除发布的包：

npm unpublish

• 让发布的包过期：

npm deprecate

12、pnpm工具

12.1、pnpm介绍

pnpm我们可以理解成是performant npm的缩写:

• 快速：pnpm比其他包管理器快2倍；
• 高效：node_modules中的文件链接自特定的内容寻址存储库；
• 支持monorepos：pnpm内置支持单仓多包；
• 严格：pnpm默认创建了一个非平铺的node_modules，因此代码无法访问任意包；

12.2、硬链接和软连接的概念

• 硬链接（hard link）：

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

• 符号链接（软链接soft link、Symbolic link）：

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

12.3、硬链接和软连接的演练

• 文件的拷贝：文件的拷贝每个人都非常熟悉，会在硬盘中复制出来一份新的文件数据

window: copy foo.js foo_copy.js
macos:  cp foo.js foo_copy.js

• 文件的硬链接

window: mklink /H aaa_hard.js aaa.js
macos:  ln foo.js foo_hard.js

• 文件的软连接

window: mklink aaa_soft.js aaa.js
macos:  ln -s foo.js foo_copy.js

12.4、pnpm到底做了什么

• 当使用npm或yarn时，如果你有100个项目，并且所有项目都有一个相同的依赖包，你在硬盘上就需要保存100份该相同依赖包的副本；
• 如果是使用pnpm，依赖包将被存放在一个统一的位置，因此：

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

12.5、pnpm创建非扁平的node_modules目录

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

意思就是，比如我只手动的安装了axios包，这时package.json文件中也只有axios的依赖配置。但由于axios自己本身又依赖了form-data包，虽然我没有主动安装form-data，但node_modules目录下还是会有form-data的包文件。这就导致我可以在我当前自己的项目中引用form-data包来使用，尽管我的package.json中并没有form-data包的依赖配置。

• 而通过pnpm创建的node_modules结构如下，让我们不能访问本不属于当前项目所设定的依赖包：
  

12.6、pnpm的安装和使用

• 我们应该如何安装pnpm呢？

• 官网提供了很多种方式来安装pnpm：pnpm安装方式
• 如果我们安装过Node，Node中有npm，所以我们通过npm安装即可；

npm install -g pnpm

• 以下是一个与npm等价命令的对照表，帮助我们快速入门：
  
• 更多命令和用法可以参考pnpm官网：pnpm官方文档

12.7、pnpm的存储store

• 我们可以通过终端命令获取pnpm的存储目录：获取当前活跃的store目录

pnpm store path

• 另外一个非常重要的store命令是prune（修剪）：从store中删除当前未被引用的包来释放store的空间

pnpm store prune