npm

此命令安装一个包和它所依赖的任何包。 如果包有一个包锁，或者一个 npm 收缩封装文件，或者一个 Yarn 锁文件，依赖的安装将由它驱动，遵循以下优先顺序：

见 package-lock.json 和 npm shrinkwrap。

一个 package 是：

即使你从不发布你的包，如果你只是想写一个 node 程序（a），你仍然可以获得使用 npm 的很多好处，也许你还想在打包后能够轻松地安装它成一个 tarball (b)。

npm install（在包目录中，无参数）：

将依赖安装到本地 node_modules 文件夹。

在全局模式下（即，将 -g 或 --global 附加到命令中），它将当前包上下文（即当前工作目录）安装为全局包。

默认情况下，npm install 将安装 package.json 中列为依赖的所有模块。

使用 --production 标志（或者当 NODE_ENV 环境变量设置为 production 时），npm 将不会安装 devDependencies 中列出的模块。 当 NODE_ENV 环境变量设置为 production 时，要安装 dependencies 和 devDependencies 中列出的所有模块，你可以使用 --production=false。

注意： 在向项目添加依赖时，--production 标志没有特殊含义。

npm install ：

如果 位于项目的根目录中，它的依赖将被安装，并且可能会像其他类型的依赖一样被提升到顶层 node_modules。 如果 位于项目的根之外， npm 不会在目录 中安装包依赖，但它会创建指向 的符号链接。

注意： 如果你想从注册表安装目录的内容（如包）而不是创建链接，则需要使用 --install-links 选项。

示例：

npm install ：

安装位于文件系统上的包。 注意： 如果你只想将一个 dev 目录链接到你的 npm 根目录，你可以使用 npm link 更容易地做到这一点。

压缩包要求：

文件名必须使用 .tar、.tar.gz 或 .tgz 作为扩展名。

包内容应位于 tarball 内的子文件夹中（通常称为 package/）。 npm 在安装包时剥离一个目录层（运行 tar x --strip-components=1 的等效项）。

包必须包含具有 name 和 version 属性的 package.json 文件。

示例：

npm install ：

获取 tarball url，然后安装它。 为了区分此选项和其他选项，参数必须以 "http://" 或 "https://" 开头

示例：

npm install [/]：

进行 @ 安装，其中 是 "tag" 配置。 （参见 config。配置的默认值为 latest。）

在大多数情况下，这将在 npm 注册表上安装标记为 latest 的模块版本。

示例：

默认情况下，npm install 将任何指定的包保存到 dependencies 中。 此外，你可以使用一些额外的标志来控制它们的保存位置和方式：

-P, --save-prod： 包将出现在你的 dependencies 中。 这是默认值，除非存在 -D 或 -O。

-D, --save-dev： 包将出现在你的 devDependencies 中。

-O, --save-optional： 包将出现在你的 optionalDependencies 中。

--no-save： 防止保存到 dependencies。

当使用上述任何选项将依赖保存到 package.json 时，还有两个额外的可选标志：

-E, --save-exact： 保存的依赖将使用精确的版本进行配置，而不是使用 npm 的默认 semver 范围运算符。

-B, --save-bundle： 保存的依赖也将添加到你的 bundleDependencies 列表中。

此外，如果你有 npm-shrinkwrap.json 或 package-lock.json，那么它也会被更新。

是可选的。 该包将从与指定范围关联的注册表中下载。 如果没有注册表与给定范围关联，则假定为默认注册表。 见 scope。

注意： 如果你不在范围名称中包含 @ 符号，npm 会将其解释为 GitHub 存储库，请参见下文。 范围名称后还必须跟一个斜杠。

例子：

注意： 如果当前工作目录中有一个名为 的文件或文件夹，那么它将尝试安装它，如果它无效，则仅尝试按名称获取包。

npm install @npm:：

在自定义别名下安装包。 允许并排同名包的多个版本，更方便地导入具有其他长包的名称，并使用 git forks 替换或分叉的 npm 包作为替换。 别名仅适用于你的项目，不会重命名传递依赖中的包。 别名应遵循 validate-npm-package-name 中规定的命名约定。

例子：

npm install [/]@：

安装指定标签引用的包的版本。 如果该包的注册表数据中不存在该标记，则此操作将失败。

示例：

npm install [/]@：

安装指定版本的包。 如果版本尚未发布到注册表，这将失败。

示例：

npm install [/]@：

安装与指定版本范围匹配的包版本。 这将遵循 package.json 中描述的解决依赖的相同规则。

请注意，大多数版本范围必须放在引号中，以便你的 shell 将其视为单个参数。

示例：