Node.js全局安装与本地安装的区别及最佳实践

全局安装与本地安装的基本概念

在之前的文章《Nodejs中 npm常用命令详解》中，我们梳理了最常用的npm命令及其相关介绍。其中涉及到了全局安装（如执行 npm install gulp -g）和本地安装（如执行 npm install gulp）两种模式。参考Gulp中文网入门指南中的图示，可以看到在通过全局方式安装gulp后，通常还需要进行本地安装。这引发了一个疑问：既然已经全局安装了gulp，为什么还要在项目中再次本地安装？难道不能直接在项目中调用全局安装的包吗？

为了解开这个疑惑，我查阅了Google上的相关文档，将零散的信息整合后逐渐理清了思路。本文将深入探讨Node.js中全局安装与本地安装的差异，若文中存在疏漏，欢迎指正。

本文的测试环境基于Windows平台，并以gulp作为示例进行讲解。

首先明确全局安装（global）的概念及其安装位置。

执行全局安装的命令为：npm install gulp -g 或 npm install gulp --global。其中参数 -g 表示将包安装到全局环境中。这些包通常位于Node.js安装目录下的 node_modules 文件夹中，具体路径一般在 \Users\用户名\AppData\Roaming\ 目录下。用户可以通过命令 npm root -g 来查看当前全局安装的具体目录。

接下来看全局安装的调用方式。

全局安装后的包主要供命令行（command line）使用。用户可以直接在命令行中运行该组件包所支持的命令。例如，全局安装gulp后，生成的cmd文件允许用户在终端直接调用相关指令，具体效果可参考全局安装gulp后的cmd文件截图。

随后了解本地安装（local）的概念及其安装位置。

执行本地安装的命令通常为：npm install gulp 或 npm install gulp --save-dev。其中参数 --save-dev 的作用是将安装包信息写入 package.json 文件的 devDependencies 字段中。此时，包会被安装在当前指定项目的 node_modules 文件夹下。

再看本地安装的调用方式。

本地安装后，可以通过 require() 的方式在项目中直接引入 node_modules 目录下的模块。例如，在本地安装gulp后，可以在 gulpfile.js 文件中直接使用 require('gulp') 来调用该模块。

为何全局安装后仍需本地安装

那么，为什么在全局安装之后，通常还需要进行本地安装呢？

仅依赖全局安装是否足够？

第一，在JavaScript实例代码中，Node.js默认会在 NODE_PATH 环境变量指定的路径以及当前js文件所在项目下的 node_modules 文件夹中查找模块。如果仅进行全局安装，无法直接通过 require() 方式引用模块，必须手动解决包路径配置问题。虽然可以将全局安装的 node_modules 文件夹复制到项目中，或者将环境变量 NODE_PATH 设置为 C:\Program Files\nodejs，但这些方法较为繁琐。

第二，全局安装不利于包的管理与更新。如果需要为每个包重新命名以区分不同项目的依赖（如 gulp@3.8.1、gulp@3.9.1...），会导致管理混乱。为了确保不同项目能正常运行并保证模块间的相互依赖关系，本地安装提供了更清晰的版本隔离。

因此，通常不推荐只进行全局安装。

本地安装的核心优势与局限性

本地安装的重要性体现在哪里？

早期的Node.js/npm主要采用全局安装模式，至今仍兼容 NODE_PATH，但这种方式不支持全局多版本共存。Node.js团队转向本地安装方法，主要目的是保证不同版本包之间的相互依赖关系。例如，weui组件中相互依赖的包多达12个。

在这些依赖包中，指定了特定的版本号，这些设定不应轻易修改。因为不同版本的包对应依赖包的功能存在差异，如果随意修改指定版本来运行weui，可能会导致编译出错或其他Bug。

再举一个关于依赖版本的例子：

涉及的包版本为：
假设A(0.0.1)依赖B(0.0.2)，而B(0.0.1)依赖C(0.0.3)。一段时间后，原作者更新了包版本，变为：A(1.0.1)依赖B（1.0.0），且B(1.0.0)依赖C(1.0.0)。

每一次更新都可能带来不同的功能变化。在多人协作、发布模块到npmjs社区或上传到GitHub供他人使用时，保留模块的版本信息对于下载指定版本号显得尤为重要。

本地安装允许每个项目拥有独立的包，不受全局包的干扰，从而方便项目的移动、复制和打包。它保证了不同版本包之间的相互依赖关系，这些优势是全局安装难以实现的。

此外，据Node.js团队介绍，本地安装包对于项目的加载速度会更快。

当然，本地安装也有缺点，例如每次新建项目时都需要本地安装所依赖的包，这会导致安装包时间相对较长。一方面是因为包体积大导致下载缓慢；另一方面是浪费了硬盘空间。不过，考虑到现代电脑硬盘容量动辄几个TB，节省这点空间通常不再是主要考量。

以上便是关于Node.js全局安装与本地安装不同之处的详细介绍，希望对大家有所帮助。如果有任何疑问，欢迎留言，小编会及时回复。在此也非常感谢大家对本站网站的支持！