已设置NODE_PATH但Node仍无法导入全局安装包，该如何解决？

问题根因 #

你查阅的是Node v0.4.x 版本的官方文档，require.paths 属性早在Node 0.6版本就已经被正式移除，打印返回undefined属于正常现象，不可再用该属性判断NODE_PATH是否生效。

解决方案 #

按以下步骤逐一排查即可解决：

• 首先确认NODE_PATH实际对Node进程生效：不要仅通过终端echo $NODE_PATH判断，直接在你的测试代码中打印process.env.NODE_PATH，核对输出是否为你配置的目标路径。如果输出为空或不符，说明shell配置未生效：
  • 如果你使用的是Bash，修改~/.bash_profile后需执行source ~/.bash_profile，重启终端后再测试
  • 如果你使用的是Zsh等其他shell，~/.bash_profile不会默认加载，需要将NODE_PATH配置写到对应shell的配置文件（如~/.zshrc、~/.zprofile）中，执行source命令生效后再测试
• 确认NODE_PATH路径配置正确：NODE_PATH需要指向全局包所在的node_modules父目录，而非包本身的路径。比如你的promised-io包安装在/some/path/node_modules/promised-io，则NODE_PATH应该配置为/some/path/node_modules
• 确认全局包安装路径和当前Node版本匹配：如果使用nvm、fnm等Node版本管理工具，不同Node版本的全局包路径相互独立，可以执行npm root -g查看当前Node版本对应的全局node_modules路径，直接将该路径添加到NODE_PATH即可
• 临时验证方案：可以在require代码前手动添加搜索路径，确认包本身无问题：

// 测试代码顶部添加
module.paths.push('/some/path/node_modules')

console.log(process.env.NODE_PATH)
var i = require('promised-io')

如果上述修改后可正常加载包，即可确认是NODE_PATH配置问题，按前序步骤修正shell配置即可。

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