如何将npm本地前缀固定为指定全局目录而非当前工作目录？

问题背景 #

• 系统环境：12.3-RELEASE FreeBSD 12.3-RELEASE r371270 NFSN64 amd64
• 全局npm前缀已设为/home/private/.npm-global，并全局安装了hexo-cli
• 在/home/public执行hexo时，命令可启动但报错找不到hexo模块，原因是npm默认将当前工作目录作为本地前缀，在该目录下找不到对应模块
• 尝试修改全局前缀、调整PATH均无效，npm local prefix无法通过npm config set修改

报错信息：

[username /home/public]$ hexo
ERROR Cannot find module 'hexo' from '/home/public'
ERROR Local hexo loading failed in /home/public
ERROR Try running: 'rm -rf node_modules && npm install --force'

解决方案 #

1. 强制Hexo使用全局模块

执行hexo时添加--no-local参数，跳过本地模块查找，直接调用全局安装的Hexo：

hexo --no-local

如果需要长期生效，可在~/.profile中添加别名：

alias hexo='hexo --no-local'

执行source ~/.profile使配置生效。

2. 让全局目录成为npm识别的本地前缀

npm的本地前缀是自动向上查找包含package.json的目录，因此可以在全局npm目录下创建package.json并安装Hexo：

# 进入全局npm目录
cd /home/private/.npm-global
# 初始化package.json（若不存在）
npm init -y
# 在该目录安装Hexo
npm install hexo

此后在任意目录执行hexo时，npm会向上找到全局目录的package.json，从而加载对应模块。

3. 设置NODE_PATH指定模块查找路径

Node.js的NODE_PATH环境变量会指定模块的优先查找路径，在~/.profile中添加：

export NODE_PATH=/home/private/.npm-global/lib/node_modules

执行source ~/.profile后，Node.js会直接从全局模块目录加载Hexo，无需依赖本地前缀。

补充说明 #

之前调整PATH仅能让系统找到hexo-cli的可执行命令，但Hexo运行时的模块查找逻辑由Node.js的模块路径规则控制，因此NODE_PATH或强制全局调用才是解决核心。

内容的提问来源于stack exchange，提问作者user8694-03