Node.js 安装与配置全攻略：从入门到高效开发

一、安装Node.js

Node.js 官网 下载 https://nodejs.org/zh-cn


一直下一步直到这个页面勾选！！！

二、验证安装是否成功

1. 检查 Node.js 和 npm 版本：

   node -v   # 查看 Node.js 版本
   npm -v    # 查看 npm 版本
   

   • 如果显示版本号（如 v18.16.0），说明安装成功。

三、配置环境变量（可选，若安装时未自动配置）

如果安装时未勾选 “Add to PATH”（或路径未自动添加），需手动配置环境变量：

1. 打开环境变量设置：
   • 右键点击 此电脑 > 属性 > 高级系统设置 > 环境变量。
2. 添加 Node.js 路径到 Path：
   • 在 系统变量 中找到 Path，点击 编辑。
   • 添加 Node.js 的安装路径（如 C:\Program Files\nodejs 或自定义路径）。
3. 添加 NODE_PATH（可选）：
   • 在 系统变量 中新建变量：
     • 变量名：NODE_PATH
     • 变量值：%AppData%\npm\node_modules（或全局模块路径）。

四、配置 npm 全局路径和缓存路径（推荐）

1. 设置全局模块存放路径

默认情况下，npm 会将全局包安装到 C:\Users\[用户名]\AppData\Roaming\npm，可能占用 C 盘空间。可自定义路径：

1. 创建目录：
   • 在安装目录下新建 node_global 和 node_cache 文件夹（如 D:\nodejs\node_global 和 D:\nodejs\node_cache）。
2. 配置 npm（需管理员权限运行命令行）：

   npm config set prefix "D:\nodejs\node_global"    # 全局模块路径
   npm config set cache "D:\nodejs\node_cache"      # 缓存路径
   

3. 验证配置：

   npm config get prefix    # 应显示自定义的全局路径
   npm config get cache    # 应显示自定义的缓存路径
   

五、配置 npm 镜像源（加速下载）

由于国际网络问题，建议切换到国内镜像源（如淘宝镜像）：

# 切换 npm 官方源到淘宝镜像
npm config set registry https://registry.npmmirror.com

# 验证是否切换成功
npm config get registry

六、配置项目级环境（可选）

1. 初始化项目：
   在项目根目录下运行：

   npm init -y    # 自动生成 package.json 文件（默认配置）
   

2. 安装项目依赖：

   npm install <包名>    # 安装本地依赖
   npm install -g <包名> # 安装全局依赖（如 `npm install -g express`）
   

七、其他注意事项

1. 权限问题：
   • 如果全局安装包时提示权限不足，需以管理员身份运行命令行（右键点击 命令提示符/PowerShell > 以管理员身份运行）。
2. 清理 npm 缓存：

   npm cache clean --force    # 清理缓存（解决安装异常时使用）
   

3. 恢复默认配置：

   npm config delete registry    # 恢复 npm 默认源
   

验证配置是否生效

1. 测试全局包安装：

   npm install -g express      # 安装全局包
   node -e "console.log(require('express'))" # 检查是否可引用
   

2. 检查路径：
   • 全局包应安装到 node_global 目录。
   • 缓存文件应存放在 node_cache 目录。