目录
一、Node.js 简介
二、下载安装
三、配置
1、配置 npm 路径
2、配置系统变量
3、修改用户变量
4、修改文件夹权限
5、（可选但推荐）配置镜像
四、验证
五、卸载
六、常见问题
一、Node.js简介
| Node.js | 说明 |
|---|---|
| 是什么 | 一个能让 JavaScript 脱离浏览器、在服务器上运行的环境，适合开发高性能、高并发的网络应用 |
| 作用 | 1.构建高性能后端服务：如 API 接口、微服务、实时应用（聊天、推送等）。 2.开发工具链支持：广泛用于前端工程化（Webpack、Vite、Babel 等依赖 Node）。 3.脚本自动化：编写本地或 CI/CD 中的自动化任务脚本。 4.全栈开发统一语言：前后端均使用 JavaScript，提升开发效率。 |
| 优点 | 1.高并发性能：非阻塞 I/O 和事件循环机制适合 I/O 密集型场景。 2.庞大生态（npm）：拥有全球最大开源库生态（超 200 万个包）。 3.活跃社区与框架支持：Express、Koa、NestJS 等成熟框架加速开发。 4.跨平台 & 快速迭代：一次编写，多端运行；版本更新快，功能持续增强。 |
二、下载安装
进入官网下载：Node.js — Download Node.js®
注：如果遇到下载慢或下载失败的，可以参考我的另一篇文章，使用Motrix下载
【告别限速！2026最新免费下载神器，下载即用】Motrix 下载神器全攻略： 超详细图文指南（保姆级教学）_闪链用不了motrix-CSDN博客
下载完成后，双击安装程序，开始安装 Node.js，点击“Next”
勾选此选项（同意用户协议），然后点击“Next”
点击修改安装目录，然后点击“Next”
自定义安装组件，一般默认不改直接点击“Next”
这一步的选项
Automatically install the necessary tools.（自动安装所需工具）
如果勾选，安装程序会自动帮你安装这些依赖项（如 Python、Visual Studio Build Tools 和 Chocolatey 包管理器）
建议勾选这个选项，让安装程序自动处理依赖
点击“Install”开始安装
点击"Finish"按钮安装完毕
一般会弹出窗口，即表示安装成功
没有弹出可以手动测试一下
按Win + R键，输入cmd，按 Enter ，打开命令行
输入以下命令运行
node -v // 检查 Node.js 版本
npm -v // 检查 npm 版本
三、配置
1、配置 npm 路径
打开安装目录，新建两个文件夹分别命名为node_global和node_cache
同理按 Win + R，输入 cmd ，按 Enter，打开命令行
输入以下命令，将路径替换为你创建文件夹的路径
npm config set prefix "你的路径\node_global"
npm config set cache "你的路径\node_cache"
比如我的路径如下：
配置好后验证，输入以下命令
npm config get prefix
npm config get cache
输出如下
2、配置系统变量
按下：WIn + R，输入：sysdm.cpl，按 Enter
在打开的「系统属性」窗口中，点击顶部的“高级”选项卡，再点击底部的“环境变量…”按钮
在系统变量区域，点击 "新建"，输入以下内容，然后点击“确定”
变量名：NODE_PATH
变量值：D:\Study\Node.js\node_global\node_modules（复制刚刚创建的node global路径并在后面添加\node modules）
再下滑找到“Path”，双击打开
点击 “新建”，输入%NODE_PATH%，然后依次点击确定关闭所有窗口
3、修改用户变量
在用户变量里面找到“Path”，双击打开
找到默认的C:\Users\<用户名>\AppData\Roaming\npm修改为：
D:\Study\Node.js\node_global（你的 node_global 的路径）
（如果没有，就直接新建一条 D:\Study\Node.js\node_global）
4、修改文件夹权限
找到node.js的安装目录，右键点击nodejs文件夹，选择“属性”
点击顶部的“安全”选项卡。点击中间的“编辑”按钮
在“组或用户名”列表中，选中Users（也就是普通用户组）
在下方的“Users 的权限”里，勾选“完全控制”这一行的“允许”框，点击“确定”
5、（可选但推荐）配置镜像
同理打开命令行，输入以下命令将 npm 镜像源设置为淘宝镜像：
npm config set registry https://registry.npmmirror.com
验证镜像配置，如图一致即配置成功
npm config get registry
四、验证
同理打开命令行 cmd，输入
npm install express -g
全局安装express模块
（之前如果没有修改文件夹属性，就用管理员身份打开cmd，输入命令运行也可以）
安装成功后，node_global文件夹下会生成node_modules目录
输入以下命令验证安装路径
npm root -g
五、卸载
如果是按本教程配置的，则将上述安装的文件夹和配置的各种变量删掉即可
如果是之前下载的，自己忘记了安装路径的，可以下载一个Everything自己查找一下
Everything下载链接：下载 - voidtools
Everything安装教程：Installing Everything - voidtools
六、常见问题
| 编号 | 问题描述 | 可能原因 | 解决方案 |
|---|---|---|---|
| 1 | 安装 Node.js 后，在命令行输入node -v或npm -v提示“不是内部或外部命令” | 系统环境变量未正确配置，或安装未成功添加到 PATH | 1. 检查是否将 Node.js 安装目录（如D:\Study\Node.js）和node_global路径加入系统 PATH。2. 重启命令行窗口或重启电脑使环境变量生效。 |
| 2 | 使用npm install -g xxx安装全局包失败，提示权限不足 | 默认 npm 全局路径位于用户目录下，但当前用户无写入权限；或未以管理员身份运行 CMD | 1. 按本教程配置了自定义node_global路径后，确保该文件夹权限已设为“Users 完全控制”。2. 或者以管理员身份运行命令提示符再执行安装命令。 |
| 3 | 安装 Node.js 后，npm 下载包极慢或超时 | 默认使用国外官方 npm registry，国内访问受限 | 配置淘宝镜像：npm config set registry https://registry.npmmirror.com或使用 cnpm/pnpm/yarn等替代工具。 |
| 4 | 卸载 Node.js 后仍有残留文件或命令可用 | 未彻底删除安装目录及环境变量 | 1. 手动删除 Node.js 安装目录（如D:\Study\Node.js）2. 清理环境变量中的相关路径（PATH、NODE_PATH） 3. 删除用户目录下的 AppData\Roaming\npm和AppData\Roaming\npm-cache（若存在） |
| 5 | 配置完node_cache后，npm 缓存仍写入默认位置 | 未正确执行npm config set cache命令，或路径含空格/中文导致解析错误 | 1. 确保路径不含中文或特殊字符 2. 以管理员身份运行 CMD 执行： npm config set cache "D:\Study\Node.js\node_cache" --global3. 验证： npm config get cache |
结尾：希望对大家有帮助！
