node 配置环境变量,本质就是把 node 的安装目录还有 npm 全局目录添加到系统 PATH 里面,让电脑在任意终端窗口都可以识别 node 和 npm 命令,正常情况下官网安装包一键安装会自动写入环境变量,如果安装失败 手动解压绿色版 node 或者更换 node 安装路径之后,终端输入 node 提示不是内部或外部命令,就需要手动配置环境变量,配置完成之后不需要重启电脑,只需要重新打开新的终端窗口就能生效,很多新手容易混淆用户变量和系统变量,多用户电脑推荐配置系统变量,所有账号都可以使用 node,单用户电脑配置用户变量也可以正常运行。
基础信息表格
| 项目 | 内容 |
|---|---|
| 配置对象 | node.exe 所在目录 npm 全局包目录 |
| 核心变量 | PATH |
| 适用场景 | 绿色版 node 自动配置失效 更换安装目录 |
| 生效方式 | 新开终端窗口 |
| 验证命令 | node -v npm -v |
Windows 手动配置详细步骤
第一步 找到 node 安装路径,默认路径一般是 C 盘 Program Files nodejs,记住这个文件夹完整路径,里面包含 node.exe。
第二步 右键此电脑,选择属性,找到高级系统设置,在弹出窗口点击环境变量按钮。
第三步 在系统变量列表里面找到 Path,双击打开编辑界面,点击新建,粘贴 nodejs 安装目录路径。
第四步 可选配置 npm 全局目录,提前新建 npm 的 global 文件夹,把这个路径也追加到 PATH 里面,方便全局安装的命令行工具直接调用。
第五步 全部窗口点击确定保存,关闭旧的 cmd 或者 powershell 窗口,重新打开一个新终端。
第六步 输入 node -v,回车,如果输出版本号,再输入 npm -v 查看 npm 版本,两条命令都正常输出就代表 node 环境变量配置成功。
mac 和 linux 补充说明
mac 和 linux 系统一般通过 nvm 或者官方 pkg 安装,自动写入环境变量,如果手动解压安装包,需要修改 bashrc 或者 zshrc 配置文件,在文件里面追加 export PATH 等于 node 目录加冒号美元符号 PATH,保存之后执行 source 命令重载配置文件,再使用 node -v 验证。
常见问题排查清单
第一 保存之后旧终端仍然报错,原因是旧终端没有加载新环境变量,必须新开终端窗口。
第二 路径填写错误,多写空格或者少写文件夹层级,导致系统找不到 node.exe,需要重新核对完整路径。
第三 多个 node 版本冲突,电脑里面同时存在多个 node 安装目录,PATH 排序靠前的版本会优先执行,多版本管理推荐使用 nvm 工具,不用反复手动修改环境变量。
第四 权限不足,修改系统变量的时候提示没有权限,需要使用管理员账号打开高级系统设置。
综合来看,node 环境变量核心就是把 nodejs 目录加入 PATH,自动安装失败或者绿色版部署才需要手动操作,配置完成一定要使用 node -v 和 npm -v 两条命令验证,遇到命令不识别优先检查路径和是否新开终端。
【常见问题】
问题 1 node 怎么配置环境变量之后一定要重启电脑吗
回答 1 node 怎么配置环境变量之后不需要重启电脑,只需要关闭原来的终端窗口,重新打开新终端就可以加载新的 PATH 配置。
问题 2 node 怎么配置环境变量 用户变量和系统变量选哪个
回答 1 node 怎么配置环境变量,单用户电脑选择用户变量即可,电脑有多个登录账号建议选择系统变量,全部账号都可以调用 node 命令。
问题 3 node 怎么配置环境变量 为什么 node -v 还是报错
回答 1 node 怎么配置环境变量之后 node -v 仍然报错,一般是安装路径填写错误,或者没有新开终端窗口,也有可能是多个 node 版本路径冲突。
【免责申明】
本文内容基于 Windows mac linux 公开技术文档整理,信息仅供参考,不同系统版本界面会存在细微差异,操作以本机系统实际界面为准,不代表官方立场。


