当前位置：首页 > news >正文

如何在Windows系统上安装和配置Node.js及Node版本管理器（nvm）

news 2026/3/26 19:26:46

Node.js是一个基于Chrome V8引擎的JavaScript运行时环境，广泛用于开发高性能的网络应用。它使得JavaScript不仅能在浏览器端运行，还能在服务器端执行。对于开发者来说，Node.js是现代Web应用的核心之一。安装和配置Node.js后，很多开发者还会使用Node版本管理器（nvm）来管理多个Node.js版本。本文将介绍如何在Windows上安装Node.js及nvm，并配置环境。

1. 检查系统要求

在安装Node.js之前，请确保你的操作系统满足以下要求：

操作系统: Windows 7或更高版本
内存: 至少2GB的内存（推荐更高）
硬盘空间: 至少500MB的可用空间

2. 下载并安装Node.js

2.1 访问Node.js官网

首先，访问Node.js的官网：Node.js官网。

官网提供两个版本的安装包：

LTS（长期支持版）：适用于生产环境，稳定且经过充分测试。
Current（当前版）：包含最新功能，但可能会不稳定，适合开发者试验新特性。

对于大多数用户，建议选择LTS版本。

2.2 下载并安装

选择适合Windows的安装包（通常为.msi文件，例如node-v18.15.0-x64.msi）。
下载完成后，双击.msi文件启动安装程序。
按照安装向导进行安装：
- 选择安装路径：建议使用默认路径C:Program Files odejs，可以自定义路径。
- 勾选Add to PATH：确保安装路径已添加到环境变量，这样可以在命令行中直接使用node和npm命令。
完成安装后，点击Finish退出安装向导。

3. 验证Node.js和npm安装

安装完成后，打开命令提示符（按Win + R，输入cmd，回车），执行以下命令来验证安装：

验证Node.js安装：
```
node -v
```
如果安装成功，返回Node.js的版本号，如：
```
v18.15.0
```
验证npm安装：
```
npm -v
```
如果npm安装成功，返回npm的版本号，如：
```
8.15.0
```

4. 安装并使用Node版本管理器（nvm）

在开发中，你可能会需要管理多个Node.js版本，例如有的项目依赖较旧的Node.js版本，而另一些项目则需要最新版本。此时，Node版本管理器nvm可以帮助你轻松切换不同的Node.js版本。

4.1 安装Node版本管理器（nvm）

访问nvm for Windows的GitHub页面：nvm-windows。
下载最新版本的nvm-setup.zip，并解压后运行nvm-setup.exe安装。
按照安装向导进行安装，默认安装路径为C:Program Files vm。
安装完成后，打开命令提示符并输入以下命令，确认nvm是否正确安装：
```
nvm -v
```
如果安装成功，将返回nvm的版本号，例如：
```
1.1.9
```

4.2 使用nvm安装和管理Node.js版本

安装指定版本的Node.js：
使用nvm安装特定版本的Node.js，例如安装Node.js 14.17.0：
```
nvm install 14.17.0
```
安装完成后，nvm会自动设置为当前版本。
查看已安装的Node.js版本：
```
nvm list
```
这将显示所有已安装的Node.js版本，如：
```
* 14.17.0 (v14.17.0) 16.0.0 (v16.0.0)
```
切换Node.js版本：
使用nvm use命令切换Node.js版本，例如：
```
nvm use 16.0.0
```
卸载Node.js版本：
如果你不再需要某个版本的Node.js，可以使用nvm uninstall命令卸载它：
```
nvm uninstall 14.17.0
```

4.3 设置默认Node.js版本

如果你希望某个版本的Node.js为默认版本（即每次打开命令行时自动使用），可以使用以下命令：

nvm alias default 16.0.0

这样，nvm use default会始终使用指定的版本。

5. 配置npm镜像（加速依赖下载）

如果你在中国大陆，由于网络限制，npm默认的注册源访问速度较慢。为了提高下载速度，可以使用淘宝的npm镜像源。

设置npm的镜像源为淘宝镜像：

npm config set registry https://registry.npm.taobao.org

验证镜像源是否更改成功：
```
npm config get registry
```
如果返回https://registry.npm.taobao.org，则说明配置成功。

6. 创建并运行第一个Node.js项目

现在，你已经安装了Node.js和nvm，并且配置了npm的镜像源。接下来，让我们通过创建一个简单的Node.js应用来测试环境。

创建项目目录：
在命令行中执行以下命令，创建一个新的项目目录并进入该目录：
```
mkdir my-node-app cd my-node-app
```
创建app.js文件：
使用文本编辑器创建一个名为app.js的文件，并在其中编写如下代码：
```
// app.js console.log("Hello, Node.js!");
```
运行项目：
在命令行中执行以下命令来运行app.js文件：
```
node app.js
```
如果安装和配置成功，你应该能看到输出：
```
Hello, Node.js!
```

7. 常见问题及解决方法

node或npm命令未找到：
- 解决方法：检查Path环境变量中是否正确配置了Node.js的安装路径。如果没有，手动将C:Program Files odejs添加到系统的Path环境变量中。
nvm安装后无法正常工作：
- 解决方法：确保安装了nvm的最新版本。如果问题仍然存在，尝试重新安装nvm。
npm下载依赖时慢：
- 解决方法：使用淘宝的npm镜像源（如上述步骤中所示）。