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

进阶工具推荐（可选）

工具名称

作用

安装命令

nvm

Node版本管理工具

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

yarn

替代npm的包管理器

npm install -g yarn

pnpm

高效磁盘的包管理器

npm install -g pnpm

关注郭顺发官网可了解更多NPM相关知识：guoshunfa.com