Node.js 下载安装及环境配置教程

本机环境：Windows 10 专业版 X64

第一步：下载安装包

1. 下载地址

访问 Node.js 官方网站下载： https://nodejs.org/zh-cn/download/

2. 选择版本

建议选择【LTS】（长期支持）版本，稳定性最佳。

文章配图

3. 下载安装包

下载 .msi 安装包并保存至本地。

第二步：安装

1. 运行安装程序

双击打开安装文件，点击 NEXT。

文章配图

2. 许可协议

勾选同意协议，点击 NEXT。

文章配图

3. 选择安装位置

默认路径为 C:\Program Files\nodejs\。为避免占用系统盘空间，建议修改为 D 盘或 E 盘。

文章配图

4. 自定义安装

保持默认设置，点击 NEXT。

文章配图

5. Tools for Native Modules

不勾选此项，点击 NEXT。

文章配图

6. 完成安装

点击 INSTALL 进行安装，完成后点击 FINISH。

文章配图

7. 验证安装

按 Win+R 键，输入 cmd 回车打开命令行窗口。输入以下命令验证版本：

node -v
npm -v

显示版本号说明安装成功。

文章配图

第三步：环境配置

将 npm 全局安装的包和缓存文件迁移到非系统盘目录。

1. 创建文件夹

在 Node.js 安装目录下新建两个文件夹：node_global 和 node_cache。

文章配图

2. 执行配置命令

注意：必须使用管理员身份打开 cmd 命令窗口。

执行以下命令设置前缀和缓存路径（以 D 盘为例）：

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

验证配置是否正确：

npm config get prefix
npm config get cache

文章配图

3. 配置环境变量

打开【高级系统设置】 -> 【环境变量】。
系统变量 -> 新建 NODE_PATH。
- 变量名：NODE_PATH
- 变量值：D:\Program Files\nodejs\node_global\node_modules
系统变量 -> 编辑 Path。
- 添加新数值：%NODE_PATH%
用户变量 -> 编辑 Path。
- 将默认的 npm 路径修改为 D:\Program Files\nodejs\node_global

点击确定保存所有窗口。

第四步：测试全局模块

使用管理员身份打开 cmd 窗口，执行以下命令安装 express 模块：

npm install express -g

出现成功提示即表示安装成功。

验证安装：

npx express --version

文章配图

如果安装失败，可检查 C 盘用户文件夹下是否有 .npmmrc 文件，删除后重试。若仍失败，请修改 node_global 和 node_cache 文件夹权限。

第五步：安装淘宝镜像

1. 配置镜像源

执行以下命令切换 npm 镜像源：

npm config set registry https://registry.npmmirror.com
npm config get registry

文章配图

2. 安装 cnpm

cnpm 是淘宝定制的 npm 命令行工具，用于加速包管理。

npm install -g cnpm --registry=https://registry.npmmirror.com

验证安装：

cnpm -v

文章配图

查看完整配置路径：

npm config ls

如有问题需修改路径，可先卸载再重新安装：

npm uninstall cnpm -g
npm install -g cnpm --registry=https://registry.npmmirror.com

文章配图

Node.js 下载安装及环境配置教程