Node.js 安装与环境配置实战指南

Node.js 安装与环境配置实战指南

下载安装

首先访问 Node.js 官网下载对应系统的安装包。这里以 Windows 64 位为例。

双击安装包开始安装，点击【Next】继续。安装路径可以根据个人习惯修改，默认即可。后续步骤保持默认选项，一路点击【Next】直到点击【Install】开始安装。

安装完成后点击【Finish】。此时建议打开命令行（Win+R 输入 cmd）验证安装是否成功：

node -v
npm -v

如果显示了版本号，说明基础环境已就绪。

环境配置

为了避免全局模块安装权限问题及文件散乱，我们需要配置 npm 的全局路径和缓存目录。

1. 创建目录

在安装目录下新建两个文件夹，例如 node_global 和 node_cache。

2. 设置 npm 配置

使用管理员身份打开 CMD，执行以下命令将前缀和缓存指向刚才创建的目录。注意替换为你实际的路径。

npm config set prefix "D:\common\develop\Nodejs\node_global"
npm config set cache "D:\common\develop\Nodejs\node_cache"

可以通过 npm config list 查看配置是否生效。

3. 环境变量配置

接下来需要更新系统环境变量，确保全局安装的模块能被系统识别。

1. 右键【此电脑】->【属性】->【高级系统设置】->【环境变量】。
2. 在【系统变量】中点击【新建】：
   • 变量名：NODE_PATH
   • 变量值：D:\common\develop\Nodejs\node_global\node_modules
3. 编辑【用户变量】中的 Path，添加 %NODE_PATH% 或具体的 node_global 路径。
4. 确认保存所有窗口。

完成上述步骤后，再次尝试全局安装模块，权限问题通常就能解决。

测试与镜像

安装测试模块

配置完成后，尝试全局安装一个常用模块（如 Express）来验证环境：

npm install express -g

如果提示权限错误，请检查是否使用了管理员身份运行 CMD，或者检查 .npmrc 配置文件是否存在冲突。若遇到 cnpm 命令不可用的情况，通常是路径未正确配置，需重新检查 prefix 设置。

配置淘宝镜像

国内网络环境下，建议使用淘宝镜像加速依赖下载。

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