Windows 10 系统上安装 Node.js 及环境配置

最新推荐文章于 2025-06-21 13:42:12 发布

lwb_0118

最新推荐文章于 2025-06-21 13:42:12 发布

阅读量1k

点赞数 23

CC 4.0 BY-SA版权

分类专栏：面试学习路线阿里巴巴文章标签： windows node.js

本文链接：https://blog.csdn.net/lwb_0118/article/details/148397630

面试同时被 3 个专栏收录

53 篇文章

订阅专栏

阿里巴巴

53 篇文章

订阅专栏

学习路线

49 篇文章

订阅专栏

在 Windows 10 系统上安装 Node.js 及环境配置

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境，让 JavaScript 可以在服务器端运行。npm (Node Package Manager) 是 Node.js 的默认包管理器，用于安装、共享和管理项目依赖的模块。

本文档将指导你如何在 Windows 10 系统上下载、安装 Node.js 和 npm，并进行基本的环境配置。

步骤一：下载 Node.js 安装程序

访问 Node.js 官方网站：
打开浏览器，访问 Node.js 官方下载页面：https://nodejs.org/en/download/
选择合适的版本：
- LTS (Long Term Support - 长期支持版): 推荐给绝大多数用户，尤其是生产环境。LTS 版本更稳定，并有较长时间的维护支持。（建议下载这个）
- Current (最新版): 包含最新的功能特性，但可能不够稳定，适合想尝试新功能的用户。
- 在下载页面，选择 Windows Installer (.msi)，并根据你的 Windows 系统是 64位还是 32位选择相应的版本（现在大部分 PC 都是 64位）。
下载安装文件：
点击对应的 Windows Installer (.msi) 链接开始下载。

步骤二：运行 Node.js 安装程序

启动安装向导：
下载完成后，双击 .msi 文件启动安装向导。
遵循安装步骤：
- Welcome: 点击 “Next”。
- License Agreement: 勾选 “I accept the terms in the License Agreement”，然后点击 “Next”。
- Destination Folder: 选择 Node.js 的安装路径，我选择安装在C盘software文件夹的nodejs文件夹下（自建文件夹）。点击 “Next”。
- Custom Setup: 这里可以选择要安装的组件。默认情况下，核心的 Node.js runtime、npm package manager 和 Add to PATH 都会被选中。务必确保 “Add to PATH” 是选中的，这样才能在任何目录下通过命令行运行 node 和 npm 命令（这里我们不用进行任何操作，就默认即可）。点击 “Next”。
- Tools for Native Modules (可选但有时需要): 这一步会询问是否自动安装必要的工具（如 Python 和 Visual Studio Build Tools），这些工具用于编译某些需要 C/C++ 编译的 npm 包（称为原生模块）。
  - 如果勾选此项，安装程序会在 Node.js 安装完成后，自动打开一个 PowerShell 窗口，并使用 Chocolatey 包管理器下载和安装这些额外的依赖。这个过程可能需要较长时间和额外的磁盘空间。
  - 如果不勾选，你可以在以后需要时手动安装这些工具。对于初学者或不确定是否需要编译原生模块的用户，可以暂时不勾选。
  - 点击 “Next”。
- Ready to Install: 点击 “Install” 开始安装。系统可能会弹出用户账户控制 (UAC) 提示，请选择 “是 (Yes)” 允许安装。
- Installation Complete: 安装完成后，点击 “Finish” 退出安装向导。

步骤三：验证安装

为了确认 Node.js 和 npm 是否已成功安装并配置到系统路径中，需要打开命令行工具进行验证。

打开命令行工具：
- 按 Win + R 键，输入 cmd 并回车，打开命令提示符 (Command Prompt)。
- 注意： 如果你刚刚完成安装，最好重新打开一个新的命令行窗口，以确保 PATH 环境变量已更新。
检查 Node.js 版本：
在命令行窗口中输入以下命令，然后按回车：
```
node -v
```
如果安装成功，会显示 Node.js 的版本号，例如 v18.17.1 (具体版本取决于你下载的版本)。
检查 npm 版本：
在命令行窗口中输入以下命令，然后按回车：
```
npm -v
```
如果安装成功，会显示 npm 的版本号，例如 9.6.7 (npm 版本通常随 Node.js 版本一起更新)。

如果这两个命令都能成功显示版本号，说明 Node.js 和 npm 已经成功安装并在你的系统 PATH 中正确配置了。

步骤四：(可选但推荐) 配置 npm 源

npm 默认从国外的官方源 (https://registry.npmjs.org/) 下载包，在国内访问可能速度较慢。可以将其配置为国内的镜像源以提高下载速度。

查看当前 npm 源：
```
npm config get registry
```
默认会显示 https://registry.npmjs.org/。

设置淘宝/npmmirror 镜像源 (推荐):

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

(npmmirror.com 是淘宝 npm 域名的新地址)

验证设置是否成功：
再次运行 npm config get registry，确认输出是否已变为你设置的镜像地址。

切换回官方源 (如果需要)：

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

步骤五：(可选但强烈推荐) 安装和使用 NVM for Windows

如果你需要同时管理和切换多个 Node.js 版本（例如，为不同的项目使用不同版本的 Node.js），强烈建议安装 NVM (Node Version Manager)。对于 Windows，有一个专门的项目叫 nvm-windows。

卸载现有 Node.js (如果已手动安装)：
nvm-windows 官方建议，在安装 nvm-windows 之前，最好先卸载通过 .msi 安装程序安装的任何现有 Node.js 版本，以免冲突。可以在 Windows 的“应用和功能”中卸载 Node.js。
- 注意: 如果你不想卸载，nvm-windows 也可以尝试管理现有版本，但先卸载通常更干净。
下载 nvm-windows 安装程序：
访问 nvm-windows 的 GitHub Releases 页面：
https://github.com/coreybutler/nvm-windows/releases
下载最新版本的 nvm-setup.zip 文件。
安装 nvm-windows：
- 解压 nvm-setup.zip 文件。
- 运行 nvm-setup.exe。
- 按照安装向导的提示进行安装。它会要求你指定 nvm 的安装目录和 Node.js 快捷方式（symlink）的目录。通常使用默认设置即可。安装程序会自动配置必要的环境变量。
验证 nvm-windows 安装：
重新打开一个新的命令行窗口 (CMD 或 PowerShell)，输入：
```
nvm -v
```
如果安装成功，会显示 nvm-windows 的版本号。
使用 nvm-windows 管理 Node.js 版本：
- 列出可安装的 Node.js 版本：
```
nvm list available
```
- 安装指定版本的 Node.js： (例如安装最新的 LTS 版本)
```
nvm install lts
```
  或者安装特定版本：
```
nvm install 18.18.0
```
- 列出已安装的 Node.js 版本：
```
nvm list
```
  当前使用的版本前会有一个星号 (*)。
- 切换使用的 Node.js 版本： (例如切换到 18.18.0)
```
nvm use 18.18.0
```
  注意： 首次切换版本或 nvm use 命令可能需要管理员权限运行命令行窗口。右键点击命令提示符或 PowerShell 图标，选择“以管理员身份运行”。
- 安装新版本的 Node.js 后，再次使用 node -v 和 npm -v 验证版本是否已切换。

步骤六：环境配置 (通常自动完成)

无论是通过 Node.js 官方 .msi 安装程序还是通过 nvm-windows 安装，通常都会自动将 Node.js 的执行路径添加到系统的 PATH 环境变量中。

PATH 环境变量： 操作系统使用 PATH 变量来查找可执行文件。将 Node.js 目录添加到 PATH 后，你就可以在任何目录下运行 node 和 npm 命令。
NODE_PATH 环境变量 (不常用)： 用于指定 Node.js 模块的额外搜索路径，现在已不推荐使用。npm 的本地和全局安装机制通常能满足需求。

如果你需要手动检查或修改环境变量：

右键点击“此电脑” (This PC) -> “属性” (Properties)。
点击“高级系统设置” (Advanced system settings)。
点击“环境变量” (Environment Variables) 按钮。
在“系统变量” (System variables)点击“新建”，输入变量名为NODE_HOME,变量值为nodejs安装路径。
在“系统变量” (System variables)找到 Path 变量，选中并点击“编辑” (Edit)。
你可以找到 Node.js 的安装路径并（例如 C:Program Files odejs）或者 nvm 创建的 Node.js 快捷方式路径（例如 C:Users<username>AppDataRoaming vm odejs 的 symlink 目标）是否包含在内。
除非你知道自己在做什么，否则不建议手动修改 PATH。

步骤七：测试

创建一个简单的 JavaScript 文件来测试 Node.js 是否正常工作。

打开记事本或任何文本编辑器。

输入以下代码：

// hello.js
console.log("Hello, Node.js on Windows!");

将文件保存为 hello.js (例如保存在你的用户目录下)。
打开命令行窗口，并 cd 到你保存 hello.js 的目录。
运行该文件：
```
node hello.js
```
如果看到输出 Hello, Node.js on Windows!，则表示 Node.js 运行环境正常。

总结

现在你已经在 Windows 10 系统上成功安装并配置了 Node.js 和 npm。你可以开始使用 Node.js 开发应用程序，或者使用 npm 安装和管理项目所需的各种 JavaScript 包了。如果选择安装了 nvm-windows，你还可以方便地管理和切换不同的 Node.js 版本。