目录一、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_globalnpm config set cache 你的路径\node_cache比如我的路径如下配置好后验证输入以下命令npm config get prefixnpm 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_global4、修改文件夹权限找到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下载链接下载 - voidtoolsEverything安装教程Installing Everything - voidtools六、常见问题编号问题描述可能原因解决方案1安装 Node.js 后在命令行输入node -v或npm -v提示“不是内部或外部命令”系统环境变量未正确配置或安装未成功添加到 PATH1. 检查是否将 Node.js 安装目录如D:\Study\Node.js和node_global路径加入系统 PATH。2. 重启命令行窗口或重启电脑使环境变量生效。2使用npm install -g xxx安装全局包失败提示权限不足默认 npm 全局路径位于用户目录下但当前用户无写入权限或未以管理员身份运行 CMD1. 按本教程配置了自定义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.js2. 清理环境变量中的相关路径PATH、NODE_PATH3. 删除用户目录下的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结尾希望对大家有帮助 【2026 最新附图文】Node.js 从下载安装、环境配置到全局运行保姆级教程（含常见问题说明）
目录一、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_globalnpm config set cache 你的路径\node_cache比如我的路径如下配置好后验证输入以下命令npm config get prefixnpm 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_global4、修改文件夹权限找到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下载链接下载 - voidtoolsEverything安装教程Installing Everything - voidtools六、常见问题编号问题描述可能原因解决方案1安装 Node.js 后在命令行输入node -v或npm -v提示“不是内部或外部命令”系统环境变量未正确配置或安装未成功添加到 PATH1. 检查是否将 Node.js 安装目录如D:\Study\Node.js和node_global路径加入系统 PATH。2. 重启命令行窗口或重启电脑使环境变量生效。2使用npm install -g xxx安装全局包失败提示权限不足默认 npm 全局路径位于用户目录下但当前用户无写入权限或未以管理员身份运行 CMD1. 按本教程配置了自定义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.js2. 清理环境变量中的相关路径PATH、NODE_PATH3. 删除用户目录下的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结尾希望对大家有帮助