NPM环境搭建指南

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：官方安装包

1. 访问 Node.js官网 (opens new window)
2. 下载 LTS版本 的 .pkg 安装包
3. 双击安装，全程保持默认设置

---

二、Windows系统安装NPM

图形化安装步骤

1. 访问 Node.js官网 (opens new window)
2. 下载 LTS版本 的 .msi 安装程序
3. 安装时注意关键选项：

• ✅ 勾选 Automatically install the necessary tools...
• ✅ 保持默认安装路径 C:\Program Files\nodejs\

1. 安装完成后验证：

   打开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