NPM node_modules

本文目录结构

node_modules 说明

npm 的工作是把将各种各样的包拉到您的计算机上，并且进行管理；

这是 Nodejs 周边生态的重要体现；

而node_modules文档就是存放这些安装包的地方。

node_modules 注意事项

• 本地安装（默认）
  • 将内容放入当前软项目根目录的./node_modules种。
• 全局安装（带有 -g）：
  • 将内容放入 /usr/local 或安装 Nodejs 的位置。
• 如果你需要require()来使用，那么你要选择本地安装需要的包。
• 如果你要在命令行上运行它，那么选择全局安装它的老铁，绝对没毛病。
• 如果两者都需要，则将其安装在两个地方，或使用 npm link。

位置查看，请使用 npm root

前置条件

该文件夹默认为全局的， nodejs 安装的位置。在大多数系统上，这是/usr/local。

• 在 Windows 上为 %AppData%\npm 。
• Unix 系统上，它是同一级的，因为 node 通常安装在 {prefix}/bin/node而不是{prefix}/node.exe。

设置global 该标志后，npm 会将东西安装到全局的node_modules中。

如果未设置，它将使用当前程序包的根目录，如果尚未在程序包中，则使用当前工作目录。

node_modules

在本地安装时，包将放入node_modules的文件夹中。

这意味着您可以 require("packagename")加载其主模块

或 require("packagename/lib/path/to/sub/module")加载其他模块。

• 在 Unix 系统上的全局安装，包会转到{prefix}/lib/node_modules。
• Windows 上的全局安装转到{prefix}/node_modules（即没有 lib 文件夹。）

范围包的安装方式相同，不同的是，它们在相关 node_modules 文件夹的子文件夹中分组在一起，并且该范围前缀的名称由 @符号表示，

例如，npm install @myorg/package 将包放在中{prefix}/node_modules/@myorg/package。

请参阅 scope 以获取更多详细信息。

如果您希望 require() 安装软件包，请在本地安装。

可执行文件

• 在全局模式下，可执行文件指向的位置

  • Unix {prefix}/bin
  • Windows 到 {prefix}

• 在本地模式下，可执行文件指向的位置；

  • ./node_modules/.bin 以便可以通过 npm 运行的脚本使用它们。
    • 例如，当您运行测试，将在路径中 npm test。

帮助手册页

• 在全局模式下，手册页链接到{prefix}/share/man。
• 在本地模式下，未安装手册页。
• 手册页未安装在 Windows 系统上。

缓存

请参阅npm-cache。

缓存文件存储在~/.npm

在 Windows 上，储存在%AppData%/npm-cache。

具体在哪里，这由 cache 配置参数控制。

临时文件

默认情况下，临时文件存储在tmp配置指定的文件夹中，该文件夹 默认为TMPDIR，TMP或TEMP环境变量；

Unix 在/tmp，Windows 上在c:\windows\temp。

临时文件在该根目录下为程序的每次运行提供一个唯一的文件夹，并在成功退出后被删除。

更多信息

在本地安装时，npm 首先尝试查找合适的 prefix 文件夹。这样 npm install foo@1.2.3，即使您碰巧 cd 进入其他文件夹，它也将安装到软件包的明智根目录。

从 $ PWD 开始，npm 将沿着文件夹树移动，检查包含 package.json 文件或 node_modules 文件夹的文件夹。如果找到这样的东西，则出于运行 npm 命令的目的，该目录将被视为有效的“当前目录”。

（此行为受 git 的。git-folder 在工作目录中运行 git 命令时的查找逻辑的启发和相似。）

如果找不到软件包根目录，则使用当前文件夹。

运行时 npm install foo@1.2.3，程序包将加载到缓存中，然后解压缩到/node_modules/foo中。

然后，将 foo 的任何依赖项类似地解压缩到中 ./node_modules/foo/node_modules/...。

任何 bin 文件都符号链接到。/node_modules/.bin/，以便 npm 脚本在必要时可以找到它们。

全局安装

如果 global 配置设置为 true，则 npm 将“全局”安装软件包。

对于全局安装，程序包的安装方式大致相同，但使用上述文件夹。

周期，冲突和文件夹简约

循环使用节点模块系统的属性来处理，该属性会在目录中查找 node_modules 文件夹。

因此，在每个阶段，如果某个软件包已经安装在祖先 node_modules 文件夹中，则不会在当前位置安装该软件包。

考虑上述情况，其中 foo -> bar -> baz。想象一下，除此之外，baz 是否依赖 bar，

因此您将拥有： foo -> bar -> baz -> bar -> baz …。

但是，由于文件夹结构为：foo/node_modules/bar/node_modules/baz，因此无需放入 bar 的另一个副本。

../baz/node_modules，因为当它调用 require("bar") 时，它将获取安装在中的副本 foo/node_modules/bar。

仅当在多个嵌套 node_modules 文件夹中安装完全相同的版本时，才使用此快捷方式。

a/node_modules/b/node_modules/a 如果两个"a"软件包是不同的版本，则仍然可能存在。

但是，无需多次重复完全相同的程序包，就始终可以防止无限回归。

可以通过在本地化的“目标”文件夹下尽可能高的级别安装依赖项来进行另一项优化。

例子

考虑以下依赖关系图：

foo
+-- blerg@1.2.5
+-- bar@1.2.3
|   +-- blerg@1.x (latest=1.3.7)
|   +-- baz@2.x
|   |   `-- quux@3.x
|   |       `-- bar@1.2.3 (cycle)
|   `-- asdf@*
`-- baz@1.2.3
    `-- quux@3.x
        `-- bar

在这种情况下，我们可能期望这样的文件夹结构：

foo
+-- node_modules
    +-- blerg (1.2.5) <---[A]
    +-- bar (1.2.3) <---[B]
    |   `-- node_modules
    |       +-- baz (2.0.2) <---[C]
    |       |   `-- node_modules
    |       |       `-- quux (3.2.0)
    |       `-- asdf (2.3.4)
    `-- baz (1.2.3) <---[D]
        `-- node_modules
            `-- quux (3.2.0) <---[E]

由于 foo 直接依赖于 bar@1.2.3 和 baz@1.2.3，因此它们将安装在 foo 的 node_modules 文件夹中。

即使 blerg 的最新副本是 1.3.7，foo 仍对版本 1.2.5 有特定的依赖性。

因此，该安装在 [A]。由于 blerg 的父安装满足 bar 对的依赖 blerg@1.x，因此不会在 [B] 下安装另一个副本。

Bar [B] 也依赖baz和 asdf，因此它们安装在bar 的node_modules文件夹中。

由于依赖于 baz@2.x，因此它无法重复使用 baz@1.2.3 父 node_modules文件夹 [D] 中安装的文件，而必须安装自己的副本 [C]。

在条形图的下面，baz -> quux -> bar 依赖项创建了一个循环。

但是，由于 bar 已经在 quux 的祖先 [B] 中，因此它不会将 bar 的另一个副本解压缩到该文件夹 ​​ 中。

在 foo -> baz[D] 下，quux 的 [E] 文件夹树为空，因为它对 bar 的依赖关系由安装在 [B] 的父文件夹副本满足。

有关安装位置的图形分类，请使用 npm ls。

发布包

发布后，npm 将在 node_modules 文件夹中查找。

如果 bundledDependencies 数组中没有任何项目，那么它们将不会包含在压缩包中。

这允许软件包维护者在本地安装其所有依赖项（和开发依赖项），

但仅重新发布在其他地方找不到的那些项。

请参阅 package.json 以获取更多信息。