Node.js 在 Windows 下的安装与目录管理全攻略

对于很多刚开始接触编程或前端开发的朋友来说，Node.js 的安装和配置可能会遇到一些小麻烦，尤其是在 Windows 系统上。今天，我们就来彻底搞懂 Node.js 在 Windows 下的安装目录问题，手把手带你从零开始，直到完全掌控。

一、Node.js 是什么？为什么需要关心安装目录？

简单来说，Node.js 是一个能让 JavaScrIPt 代码在电脑上直接运行的环境，而不是只能在浏览器里运行。它让 JavaScript 成为了一个全能的编程语言，可以用来开发网站后台、桌面应用甚至手机应用。

了解安装目录很重要，因为：

安装时知道装在哪里，方便后续管理
配置环境变量时需要知道路径
卸载或升级时需要找到相关文件
多个版本切换时需要管理不同目录

二、Node.js 安装步骤详解

1. 下载安装包

首先访问 Node.js 官方网站，你会看到两个版本：

LTS 版本：长期支持版，稳定可靠，适合大多数用户
Current 版本：最新版，包含新特性，但可能不够稳定

建议新手选择 LTS 版本下载 Windows 安装包（.msi 文件）。

2. 安装过程

双击下载好的安装包，按照提示一步步操作：

1. 欢迎界面 → 点击“Next”
2. 许可协议 → 勾选“I accept...” → 点击“Next”
3. 选择安装位置（重点！）

安装位置选择界面：这里你会看到一个默认路径，通常是：

C:\Program Files\nodejs\

给新手的建议：

如果你只有一块硬盘，直接使用默认路径即可
如果你想安装到其他位置，可以点击“Change...”按钮修改
推荐路径：D:\nodejs\ 或 E:\Programs\nodejs\（如果D盘或E盘是数据盘）

重要提示：安装路径中不要包含中文或特殊字符，最好全是英文和数字。

3. 功能选择

安装程序会让你选择安装哪些功能：

Node.js runtime：核心运行环境（必须安装）
npm package manager：Node.js 的包管理工具（必须安装）
Online documentation shortcuts：在线文档快捷方式（可选）
Add to PATH：添加到系统环境变量（强烈建议勾选！）

一定要勾选“Add to PATH”，这样你才能在任意位置使用 Node.js 命令。

4. 完成安装

点击“Install”开始安装，等待进度条完成，最后点击“Finish”。

三、验证安装是否成功

安装完成后，需要检查是否安装正确。

方法1：使用命令提示符

按 Win + R 键，输入 cmd，按回车
在弹出的黑色窗口（命令提示符）中输入：
```
node --version
```
如果显示类似 v18.12.1 的版本号，说明 Node.js 安装成功
再输入：
```
npm --version
```
如果显示类似 8.19.2 的版本号，说明 npm 也安装成功

方法2：查看安装目录

打开文件资源管理器，进入你选择的安装目录，应该能看到这些内容：

nodejs/
├── node.exe          # Node.js 主程序
├── npm.cmd           # npm 命令脚本
├── npx.cmd           # npx 命令脚本
├── node_modules/     # 全局安装的包存放处
│   └── npm/          # npm 自身的文件
└── 其他文件...

四、安装目录结构详解

了解目录结构能帮你更好地管理 Node.js。

1. 核心文件

node.exe：Node.js 的核心执行文件
npm：Node.js 的包管理器，用于安装第三方模块
npx：用于临时运行包的工具

2. 重要子目录

node_modules：存放全局安装的包
node_cache：npm 的缓存目录（可能需要手动创建）
node_global：全局安装包的目录（建议手动创建并配置）

五、自定义安装目录的配置

如果你修改了默认安装路径，或者想要更好地管理 Node.js，需要进行一些配置。

1. 配置全局安装路径（推荐）

默认情况下，全局安装的包会放在安装目录的 node_modules 中，但我们可以改到其他位置。

操作步骤：

在D盘（或其他非系统盘）创建两个文件夹：
- D:\nodejs\（如果安装时没选这里）
- D:\nodejs\node_global（用于全局包）
- D:\nodejs\node_cache（用于缓存）

配置新的路径：打开命令提示符，依次输入：

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

2. 配置系统环境变量

为了让系统能找到我们自定义的路径：

右键点击“此电脑” → 选择“属性”
点击“高级系统设置” → 点击“环境变量”
在“系统变量”部分找到“Path” → 点击“编辑”

点击“新建”，添加两个路径：

D:\nodejs\              # Node.js 主程序路径
D:\nodejs\node_global   # 全局包路径

点击“确定”保存所有设置

六、常见问题与解决方案

问题1：安装时提示“权限不足”

解决方案：

右键点击安装包，选择“以管理员身份运行”
或者将安装路径改为用户目录，如：C:\Users\你的用户名\nodejs

问题2：命令提示符中找不到 node 命令

解决方案：

检查安装时是否勾选了“Add to PATH”
如果没有，可以手动添加环境变量（方法见上文第五部分）
或者重新安装，记得勾选该选项

问题3：安装速度慢或失败

解决方案：

设置 npm 镜像源（使用国内镜像加速）：

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

清除缓存后重试：
```
npm cache clean --force
```

问题4：多个 Node.js 版本如何管理？

解决方案：使用 nvm-windows（Node Version Manager for Windows）

先卸载当前 Node.js
下载 nvm-windows：在 GitHub 搜索“nvm-windows”
安装 nvm-windows

使用命令管理多个版本：

nvm list available      # 查看可安装版本
nvm install 18.12.1     # 安装指定版本
nvm use 18.12.1         # 使用指定版本
nvm list                # 查看已安装版本

七、最佳实践建议

1. 目录规划

D:\
├── nodejs\              # Node.js 主程序
│   ├── node_global\     # 全局包
│   └── node_cache\      # 缓存
├── Projects\            # 项目目录
│   ├── project1\
│   └── project2\
└── Tools\               # 其他开发工具

2. 日常维护

定期更新 npm：npm install -g npm@latest
清理缓存：npm cache clean --force
检查过时包：npm outdated -g

3. 项目级管理

在每个项目目录中使用本地安装：

# 进入项目文件夹
cd D:\Projects\my-project

# 初始化项目（会创建 package.json 文件）
npm init -y

# 本地安装包（会安装到项目下的 node_modules）
npm install 包名

# 全局安装工具类包
npm install -g 工具名