NPM(Node Package Manager)是 Node.js 的包管理工具,堪称前端开发的基石。本文将手把手教你 在Mac、Windows、Linux三大系统上快速搭建NPM环境,并验证是否成功。
一、Mac系统安装NPM
方法1:通过Homebrew安装(推荐)
# 1. 安装Homebrew(已安装可跳过)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 2. 安装Node.js(包含npm)
brew install node
# 3. 验证安装
node -v # 应输出如 v20.13.1
npm -v # 应输出如 10.5.2
方法2:官方安装包
- 访问 Node.js官网 (opens new window)
- 下载 LTS版本 的
.pkg
安装包 - 双击安装,全程保持默认设置
二、Windows系统安装NPM
图形化安装步骤
- 访问 Node.js官网 (opens new window)
- 下载 LTS版本 的
.msi
安装程序 - 安装时注意关键选项:
- ✅ 勾选 Automatically install the necessary tools...
- ✅ 保持默认安装路径
C:\Program Files\nodejs\
-
安装完成后验证:
打开CMD或PowerShell
node -v
npm -v
三、Linux系统安装NPM
Ubuntu/Debian系
# 1. 安装Node.js和npm
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt install -y nodejs
# 2. 验证
node -v && npm -v
CentOS/RedHat系
# 1. 添加NodeSource仓库
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
# 2. 安装
sudo yum install nodejs -y # 或使用 dnf
Arch/Manjaro系
sudo pacman -S nodejs npm
四、通用配置(提升体验)
1. 配置国内镜像源(加速下载)
# 切换淘宝镜像
npm config set registry https://registry.npmmirror.com
# 验证配置
npm config get registry
2. 升级npm到最新版
npm install -g npm@latest
五、验证环境是否就绪
所有系统均执行:
# 检查版本
node -v
npm -v
# 创建测试项目
mkdir npm-test && cd npm-test
npm init -y
npm install lodash
若成功生成 package.json
和 node_modules
目录,则环境正常!
常见问题解决
1. 命令未找到(command not found)
- ✅ Windows用户检查是否重启终端
- ✅ Linux/Mac用户确认安装时使用了
sudo
2. EACCES权限错误(Linux/Mac)
# 修复全局包安装权限
sudo chown -R $USER /usr/local/lib/node_modules
3. 镜像源失效
# 重置为官方源
npm config set registry https://registry.npmjs.org
关注郭顺发官网可了解更多NPM相关知识:guoshunfa.com