为何npm全局安装web3（npm install -g web3）无法在Node.js中使用？

这个问题其实和Node.js的模块查找规则直接相关，咱们拆解下原因和解决办法：

核心原因 #

Node.js在处理require()调用时，默认的模块搜索路径是：

1. 当前执行脚本所在目录下的node_modules文件夹
2. 逐级向上父目录的node_modules（直到根目录）
3. Node.js内置的模块（比如fs、path这类）

而全局安装的npm包，会被放到npm的全局存储目录里（比如/usr/local/lib/node_modules或者用户目录下的.npm-global），这个路径不在Node.js默认的搜索列表里。所以当你全局装了web3，本地脚本用require('web3')时，Node.js找不到对应的包，就会抛出“Cannot find module”的错误。

对比本地安装的情况：npm install web3会把web3包直接放在当前项目的node_modules里，正好在Node.js的搜索路径内，所以脚本能正常运行。

解决办法 #

这里给几个实用的方案，你可以根据需求选：

• 方案一：通过NODE_PATH环境变量告诉Node.js全局包位置
  首先先找到你的npm全局模块路径，运行：

  npm root -g
  

  然后把这个路径临时加入到NODE_PATH里：

  export NODE_PATH=$(npm root -g)
  

  现在再运行./main.js就能正常加载全局的web3了。如果想让这个配置永久生效，可以把这条export命令添加到你的shell配置文件里（比如~/.bashrc、~/.zshrc或者~/.profile），下次启动终端就自动生效了。

• 方案二：用npm link把全局包链接到本地项目
  进入你的项目目录，运行：

  npm link web3
  

  这个命令会在当前项目的node_modules文件夹里创建一个指向全局web3包的软链接，相当于让本地项目“借用”全局安装的包，既享受到全局安装的便利，又能让require()正常找到模块。

• 方案三：直接require全局包的绝对路径（不推荐）
  你也可以在脚本里直接写全局web3的绝对路径，比如：

  const web3 = require('/usr/local/lib/node_modules/web3');
  

  但这种方式非常不灵活，换个环境或者全局包路径变了就会失效，所以一般不建议这么做。

额外建议 #

其实对于web3这种作为项目代码依赖的包，更推荐本地安装。因为本地安装可以让每个项目拥有独立的依赖版本，避免不同项目之间的版本冲突；而全局安装更适合那些提供命令行工具的包（比如npm、webpack-cli这类）。

内容的提问来源于stack exchange，提问作者user1424739