一、安装Node.js
Node.js 官网 下载 https://nodejs.org/zh-cn
一直下一步直到这个页面勾选!!!
二、验证安装是否成功
-
检查 Node.js 和 npm 版本 :
bashnode -v # 查看 Node.js 版本 npm -v # 查看 npm 版本
- 如果显示版本号(如
v18.16.0
),说明安装成功。
- 如果显示版本号(如
三、配置环境变量(可选,若安装时未自动配置)
如果安装时未勾选 "Add to PATH"(或路径未自动添加),需手动配置环境变量:
- 打开环境变量设置 :
- 右键点击 此电脑 > 属性 > 高级系统设置 > 环境变量。
- 添加 Node.js 路径到
Path
:- 在 系统变量 中找到
Path
,点击 编辑。 - 添加 Node.js 的安装路径(如
C:\Program Files\nodejs
或自定义路径)。
- 在 系统变量 中找到
- 添加
NODE_PATH
(可选) :- 在 系统变量 中新建变量:
- 变量名 :
NODE_PATH
- 变量值 :
%AppData%\npm\node_modules
(或全局模块路径)。
- 变量名 :
- 在 系统变量 中新建变量:
四、配置 npm 全局路径和缓存路径(推荐)
1. 设置全局模块存放路径
默认情况下,npm 会将全局包安装到 C:\Users\[用户名]\AppData\Roaming\npm
,可能占用 C 盘空间。可自定义路径:
-
创建目录 :
- 在安装目录下新建
node_global
和node_cache
文件夹(如D:\nodejs\node_global
和D:\nodejs\node_cache
)。
- 在安装目录下新建
-
配置 npm (需管理员权限运行命令行):
bashnpm config set prefix "D:\nodejs\node_global" # 全局模块路径 npm config set cache "D:\nodejs\node_cache" # 缓存路径
-
验证配置 :
bashnpm config get prefix # 应显示自定义的全局路径 npm config get cache # 应显示自定义的缓存路径
五、配置 npm 镜像源(加速下载)
由于国际网络问题,建议切换到国内镜像源(如淘宝镜像):
bash
# 切换 npm 官方源到淘宝镜像
npm config set registry https://registry.npmmirror.com
# 验证是否切换成功
npm config get registry
六、配置项目级环境(可选)
-
初始化项目 :
在项目根目录下运行:bashnpm init -y # 自动生成 package.json 文件(默认配置)
-
安装项目依赖 :
bashnpm install <包名> # 安装本地依赖 npm install -g <包名> # 安装全局依赖(如 `npm install -g express`)
七、其他注意事项
-
权限问题 :
- 如果全局安装包时提示权限不足,需以管理员身份运行命令行(右键点击 命令提示符/PowerShell > 以管理员身份运行)。
-
清理 npm 缓存 :
bashnpm cache clean --force # 清理缓存(解决安装异常时使用)
-
恢复默认配置 :
bashnpm config delete registry # 恢复 npm 默认源
验证配置是否生效
-
测试全局包安装 :
bashnpm install -g express # 安装全局包 node -e "console.log(require('express'))" # 检查是否可引用
-
检查路径 :
- 全局包应安装到
node_global
目录。 - 缓存文件应存放在
node_cache
目录。
- 全局包应安装到