要让 Node.js 支持全局路径的模块搜索 (即可以识别你全局安装的模块如 express
),你需要配置 NODE_PATH
环境变量。以下是详细步骤,适用于 Windows 系统:
✅ 第一步:确认全局模块安装位置
在终端中运行:
npm config get prefix
输出示例:
D:\npm-global
那么全局模块路径就是:
D:\npm-global\node_modules
✅ 第二步:设置 NODE_PATH
环境变量
方法一:通过系统界面设置(推荐)
-
打开系统环境变量:
- 右键点击「此电脑」 → 属性 → 高级系统设置 → 环境变量。
-
添加用户变量:
-
点击「新建」,变量名输入:
NODE_PATH
-
变量值输入:
D:\npm-global\node_modules
注意:路径中不应加引号,不加末尾斜杠。
-
-
确认 → 确认 → 关闭窗口。
-
重启终端或编辑器(如 VS Code、PyCharm),使变量生效。
✅ 第三步:验证配置是否生效
echo %NODE_PATH%
在终端中运行以下 Node.js 命令:
node -p "require('express')"
如果输出中包含你设置的全局路径,比如:
[
...
'D:\\npm-global\\node_modules',
...
]
说明已经配置成功。
你现在就可以在 Node.js 项目中使用 require('express')
来加载全局模块了(虽然不推荐这么做,开发中还是建议本地安装)。
❗注意事项
-
设置
NODE_PATH
是全局生效,所有 Node.js 项目都能读取到。 -
如果你使用的是
nvm
、nvs
、volta
这类 Node 管理工具,也需要对它们设置。
✅ 示例测试
创建 test.js
:
const express = require('express');
console.log('Express 加载成功!');
在终端运行:
node test.js
如果看到输出,说明全局 express
被成功引用。
是否需要我为你写一个批处理脚本自动设置 NODE_PATH
?