Windows 下 Node.js 安装与环境配置指南

Windows 下 Node.js 安装与环境配置指南

Node.js 作为服务端 JavaScript 运行环境，基于 Chrome V8 引擎，采用事件驱动和非阻塞 I/O 模型，轻量且高效。配合 npm 包管理器，它构成了全球最大的开源库生态系统之一。在 Windows 平台上搭建开发环境，除了完成基础安装，合理配置环境变量和全局模块路径也是提升体验的关键。

下载安装

首先访问 Node.js 官网下载页面：https://nodejs.org/zh-cn/download/

建议选择 LTS（长期支持）版本。安装包通常为 .msi 格式，例如 node-v20.x.x-x64.msi。根据系统位数选择对应版本，目前主流为 64 位。

安装步骤

1. 运行安装程序 双击下载的 .msi 文件启动安装向导。点击【Next】继续。

2. 接受协议 勾选"I accept the terms in the License Agreement"复选框，然后点击【Next】。

3. 选择安装目录 默认路径通常位于 C 盘。如果 C 盘空间紧张，建议修改为其他盘符，例如 D:\Develop\nodejs。点击【Next】确认。

4. 完成安装 等待进度条走完，点击【Finish】退出安装向导。

验证安装

安装完成后，先简单测试一下是否生效。按下 Win + R 键，输入 cmd 打开命令行窗口。

依次输入以下命令查看版本信息：

node -v
npm -v

如果终端输出了版本号，说明安装成功。新版 Node.js 已自带 npm，无需单独安装。

环境变量配置

虽然 Node.js 可以正常运行，但默认情况下，使用 npm install -g 安装的全局模块会存放在用户目录下的 AppData 文件夹中，这会导致 C 盘空间被占用，且路径过长不便管理。因此，推荐自定义 npm 的全局模块路径和缓存路径。

1. 创建专用文件夹

在你希望存放 Node.js 相关文件的目录下（例如 D:\Develop\nodejs），新建两个文件夹：

• node_global：用于存放全局安装的模块
• node_cache：用于存放 npm 缓存

2. 设置 npm 配置

打开 cmd 命令窗口，执行以下两条命令来指定路径。注意路径中的反斜杠可能需要转义，或者直接使用正斜杠。

npm config set prefix "D:\Develop\nodejs\node_global"
npm config set cache "D:\Develop\nodejs\node_cache"

3. 配置系统环境变量

关闭 cmd 窗口，右键点击"此电脑"或"我的电脑"，选择"属性" -> "高级系统设置" -> "环境变量"。

• 新建系统变量：在"系统变量"区域点击"新建"，变量名填 NODE_PATH，变量值填 D:\Develop\nodejs\node_global\node_modules。
• 修改 Path 变量：在"用户变量"或"系统变量"中找到 ，双击编辑，将 添加到列表末尾。