Windows系统Node.js完整安装与配置教程
本文详细介绍在Windows操作系统上安装Node.js的完整流程。涵盖从官网下载LTS版本、自定义安装路径,到配置全局模块目录node_global和缓存目录node_cache。同时讲解如何通过命令行修改系统环境变量,以及使用淘宝镜像加速npm包安装并配置cnpm,确保开发环境高效稳定。
一、安装环境
在开始安装 Node.js 之前,请确保您的计算机满足以下基础条件:
操作系统:Windows
命令行工具:Node.js 主要依赖命令行进行管理和运行,建议在 Windows 系统中使用命令提示符(cmd)或 PowerShell。
代码编辑器:开发 Node.js 应用通常需要使用文本编辑器或集成开发环境,推荐选用 Visual Studio Code、Sublime Text 或 Atom 等主流工具。
网络连接:安装 Node.js 核心程序及后续下载第三方模块时均需访问互联网,请确保网络连通且稳定。
二、安装步骤
以下是 Windows 环境下安装 Node.js 的具体操作流程:
- 打开浏览器访问 Node.js 官方网站 https://nodejs.org/ ↗。
- 首页会显示当前推荐的“长期支持版本”(LTS)和最新版本。建议点击“长期支持版本”进行下载,以获取更稳定的 Node.js 安装包。

- 下载完成后,双击运行安装程序。在安装向导中点击“Next”,当出现路径选择界面时,请注意查看默认安装路径。
- 若需更改安装位置,点击“Change”按钮,将其修改为您指定的目录(例如 D 盘),随后继续点击“Next”直至安装完成。
三、验证安装
安装结束后,打开 CMD 命令行工具,输入以下命令以检查安装状态:
node -v该命令将输出 Node.js 的版本号。若输出的版本号与您下载的版本一致,即表明安装成功。

四、修改全局安装路径、缓存路径,环境变量配置
默认情况下,node_global 用于存储全局安装的 Node.js 模块,而 node_cache 用于存储 npm 下载的缓存文件。
在 node_global 目录中,存放着全局安装的 Node.js 模块相关文件及元数据,包括源代码、可执行文件、依赖项和描述文件等。由于这些模块已全局安装,它们可在系统任意位置被调用。
相对而言,node_cache 目录保存的是已下载的 Node.js 模块缓存。每次执行 npm install 命令安装模块时,npm 会优先在 node_cache 目录中查找缓存。若找到匹配项,npm 将直接使用缓存文件以加速安装,避免重复下载,从而节省时间与带宽。
需注意,node_global 目录与 node_cache 目录相互独立。若修改了其中任一目录的路径,全局模块和缓存文件将自动保存至新路径。
若未自定义全局目录 node_global,全局安装的文件默认保存在 C:\用户\user\AppData\Roaming\npm(其中 user 为当前计算机用户名)。
因此,安装 Node.js 后,建议手动配置 node_global 和 node_cache(缓存文件夹)。
请在 Node.js 的安装目录下,手动创建 node_global 和 node_cache 两个文件夹。

打开 cmd 命令提示符,依次执行以下配置命令:
npm config set prefix "D:\Nodejs\node_global"
npm config set cache "D:\Nodejs\node_cache"执行 npm config set prefix “D:\Nodejs\node_global” 可将 Node.js 全局模块的安装路径指定为 “D:\Nodejs\node_global”。此后使用 npm install -g 全局安装模块时,文件将存入该目录。
执行 npm config set cache “D:\Nodejs\node_cache” 可将模块缓存路径指定为 “D:\Nodejs\node_cache”。使用 npm install 安装模块时,缓存将保存至该目录。
3. 修改系统环境变量
在 Windows 系统中,可通过以下步骤配置环境变量:
- 点击“开始”菜单,搜索并打开“控制面板”。
- 在控制面板中,点击“系统和安全”选项。
- 选择“系统”,并在左侧菜单中点击“高级系统设置”。
- 在弹出的系统属性窗口中,点击“环境变量”按钮,进入环境变量编辑界面。
或者,您也可以通过命令提示符(cmd)快速打开环境变量编辑器:
打开 cmd 窗口,输入以下命令并按回车执行:
rundll32.exe sysdm.cpl,EditEnvironmentVariables此操作将直接打开环境变量编辑器,如图所示:

在“用户变量”列表中找到 Path 变量,点击“编辑”。在变量值中追加一行 D:\Nodejs\node_global。若已存在 C:\Users\【 AppData\Roaming\npm 】路径,请将其修改为 D:\Nodejs\node_global,然后点击“确定”。
点击“确定”保存更改。

在“系统变量”区域,新建一个名为 NODE_PATH 的变量,其变量值设置为 D:\Nodejs\node_global\node_modules。

修改完成后,再次在系统变量中找到 Path 变量,在末尾追加以下内容:
%NODE_PATH%
点击“确定”保存所有设置。
五、测试
1. 使用 npm install express -g 命令全局安装 Express 模块。

若安装过程中报错,请检查 D:\Nodejs 文件夹权限是否不足。右键点击文件夹,选择“属性”->“安全”->“编辑”,确保所有用户拥有“完全控制”权限,勾选后点击“应用”和“确定”。

权限设置完成后,重新执行安装命令:

若显示 Successful!,则表示安装成功。
六、更改淘宝镜像
npm 初始源指包管理器默认使用的官方源。由于全球访问速度差异,部分地区连接官方源可能缓慢或不稳定。为此,许多开发者选择使用淘宝镜像源以提升国内访问速度和稳定性。
淘宝源由淘宝团队在国内搭建,旨在优化 Node.js 开发者的 npm 使用体验。相比官方源,淘宝源下载速度更快,国内访问更稳定。
1. 要将 npm 默认源切换为淘宝源,请执行以下命令:
npm config set registry https://registry.npm.taobao.org此命令将默认源更改为淘宝源。如需恢复官方源,可执行以下命令:
npm config set registry https://registry.npmjs.org请注意,更改 npm 源可能带来不可预知的影响。操作前请仔细阅读相关文档,了解潜在后果。

2. 运行 npm config get registry 命令,可查看当前 npm 源的 URL:
npm config get registry
3. 使用淘宝源全局安装 cnpm。cnpm 是基于 npm 的淘宝定制版,可加速国内 Node.js 包的安装。执行以下命令:
npm install -g cnpm --registry=https://registry.npm.taobao.org上述命令旨在通过设置淘宝源加速国内 npm 包安装。首先将源设为淘宝源,使 npm 自动使用镜像;随后全局安装 cnpm,以便在命令行中通过 cnpm 命令替代 npm,实现更快的包安装体验。
需注意,使用 cnpm 替代 npm 时,部分命令可能不支持或行为不同。此外,cnpm 可能与某些 npm 依赖包存在兼容性问题。使用前请充分了解其特性与限制,并根据实际需求选择。
如图所示,安装成功界面如下:


至此配置完成。若遇错误,请仔细检查环境变量设置是否正确。



以上即为 Node.js 在 Windows 下的完整安装与配置教程。如需了解更多相关内容,请搜索本站往期文章或继续浏览后续文章,感谢您的支持!
Java和JavaScript的应用场景分工:后端企业级开发与Web前端交互
2026-11-05 15:57:34
除了浏览器和Node.js,还有哪些轻量级Js脚本运行工具?
2026-11-04 17:38:24
无需后端:用JavaScript实现简单网站的本地数据存储
2026-11-03 23:03:30
Node.js 下载慢或官网打不开怎么办
2026-11-03 18:19:37
JS解析大体积Excel文件内存溢出怎么办
2026-11-03 18:19:37
