npm的包管理以及安装方式

最新推荐文章于 2024-09-10 10:14:16 发布

TIMI-Nian

最新推荐文章于 2024-09-10 10:14:16 发布

阅读量2.1k

点赞数

分类专栏：前端文章标签： npm node

前端专栏收录该内容

7 篇文章 0 订阅

订阅专栏

npm 是一个方便的 Node 模块分发、管理工具。我们平常会使用 npm install 安装模块，使用 npm publish 发布模块。事实上除了基本功能，这 2 个命令还有其他非常有用的特性。这篇文章会给大家介绍这些命令的一些“高级”用法。
盗窃可耻，尊重原著。在理解原著后，稍加整理和修改。原文地址

1.模块的版本号

参考另外一个文章版本号如何管理

2.模块的依赖管理

在进行项目开发时，对于依赖的模块进行管理是非常必要的。这种管理主要体现在：

如何方便的获取项目需要使用的模块
当前项目依赖了哪些模块，或许还会指定模块依赖的环境（哪些模块是生产阶段依赖的、哪些是开发阶段依赖的）
模块的哪些版本是和当前项目兼容的，可以直接使用
其他成员（或者系统）如何方便的获取所有模块，从而能让项目正常运行
获取模块

我们在进行项目开发时，如果需要某个功能，都会先去 npm registry 上搜一搜，看看有没有类似的模块可以直接复用，从而提高开发效率。获取模块非常简单，我们在项目的根目录直接执行 npm install name 就可以将模块安装在 node_modules 目录下，然后直接 require 就可使用。

2.1 依赖了哪些模块

上面获取模块的方法是一种“临时”起意的方式，并不能记录我们依赖模块的具体信息（除非我们自己去查找）。我们安装模块时，可以执行 npm install name --save（生产阶段的依赖） 或是 npm install name --save-dev（开发阶段的依赖），来将模块信息保存到项目的 package.json 文件中。

模块依赖表示法
执行 npm install name --save 来安装模块时，npm 会首先安装模块的最新版本，然后将模块名及模块版本号以最“保险”的表示方式写入到 package.json 文件中。

比如，我们执行 npm install koa --save，安装模块后，会更新package.json文件的 dependencies 字段：

{
  "dependencies": {
    "koa": "~1.1.0"
  }
}

项目对模块的依赖可以使用下面的 3 种方法来表示（假设当前版本号是 1.1.0 ）：

兼容模块新发布的补丁版本：~1.1.0、1.1.x、1.1
兼容模块新发布的小版本、补丁版本：^1.1.0、1.x、1
兼容模块新发布的大版本、小版本、补丁版本：*、x

可以看到，npm 默认会将依赖表示为最“保险”的方式（即：获取模块新发布的补丁版本），我们也可以使用 npm install koa --save-exact 来精确的指定模块版本（这种情况依赖就直接表示为："koa": "1.1.0"）。

除了获取模块的最新版本，我们还可以精确获取模块的某个具体版本，如：npm install koa@1.0.0 --save，这种情况依赖就会表示为："koa": "~1.0.0"。

上边这三种表示方式的目的是：当你定义了package.json后，别人拿到项目在执行npm install的时候，npm可以根据定义来确定安装模块的哪个版本。
比方："koa": "1.1.0"，根据上边第一种情况，npm只会安装兼容1.1.0这个版本的发布，如果koa当前的最新版本是v1.3.5，在历史版本中还有一个v1.1.9，那么npm就会安装v1.1.9，而不会安装v1.3.5甚至是v1.2.0。从版本定义规则可以知道，X.Y.Z中 Z的变化只是修改bug，不会引入新的变更或增加新的功能，这样不会造成安装进来的模块出现兼容性问题。

2.2 安装模块

模块的依赖都被写入了 package.json 文件，其他合作者（比如：其他小伙伴、或者是部署服务）只要进入项目的根目录，执行 npm install 就可以将依赖的模块全部安装到 node_modules 目录下。

比如下面的 package.json：

{
  "dependencies": {
    "bluebird": "~3.1.1",
    "request-promise": "^1.0.2",
    "lodash": "*"
  },
  "devDependencies": {
    "mocha": "~2.3.4"
  }
}

当我们执行 npm install 时，就会安装 dependencies 及devDependencies 字段里列出的所有模块。如果只想安装 dependencies 里面列出的模块，可以使用 npm install --only=production。

这里 npm 实际安装的模块是根据依赖的表示来决定的：

"bluebird": "~3.1.1" 表示会安装最新的补丁版本。比如：安装3.1.2、3.1.3 等，但是不会安装 3.2.0这种小版本或者4.0.0这种大版本（就算这些版本是最新的）。这种表示法是比较保险的，因为补丁版本只是 bug 修复，不会新增功能。
"request-promise": "^1.0.2"表示会安装最新的补丁版本或者小版本。比如：安装 1.1.0、1.1.1 等小版本，或者 1.0.3、1.0.4 等补丁版本，但是不会安装 2.0.0这种大版本。而且，总是安装版本号最大的（也就是优先安装小版本）。这种表示法通常是保险的，小版本会增加向后兼容的功能。
"lodash": "*"表示安装最新的版本（不管这个版本是大版本、小版本、还是补丁版本）。这种表示法非常危险，如果有大版本，直接就安装了大版本，而大版本通常是不会向后兼容的，可能导致项目功能运行异常。

3. 模块的发布

对于模块的提供者来说，每一次发布都应该尽量遵循 semver 的规范来变更版本号，不要让用户困惑甚至是想骂人……

在“模块的版本号”部分我们介绍了 semver 规范，npm 也提供了相关的命令来让我们方便的进行版本号变更：

升级补丁版本号：npm version patch
升级小版本号：npm version minor
升级大版本号：npm version major

一个比较合适的发布流程可以是：
- 1) 根据此次变更执行 npm version [new version] 命令（npm 会根据 new version 指定的类型更新 package.json 中的 version 字段，然后进行一次 commit，最后打上一个该版本号的 tag）。
- 2) 执行 git push origin master --tags，将改动同步到远程代码仓库。
- 3) 执行npm publish，将模块发布到 npm 仓库。

模块的 tag

模块安装命令的最简形式 npm install name 的完整版其实应该是：npm install name@latest。这里的 latest 是模块版本的一个 tag，会对应到模块的一个具体版本。

我们来看一个例子：模块 koa 在 npm registry 上的信息如下（完整版见：npm registry）：

{
  "name": "koa",
  "dist-tags": {
    "latest": "1.1.2",
    "next": "2.0.0-alpha.3"
  },
  "versions": {
    "0.0.1": {...},
    "1.1.2": {...},
    "2.0.0-alpha.3": {...}
  }
}