如何安装 Node.js 与 npm:新手完全指南
无论你是刚接触前端开发,还是准备搭建一个个人博客,Node.js 和 npm 都是必不可少的工具。这篇指南会带你从零开始,在三大主流操作系统上完成安装。
一、Node.js 与 npm 是什么
Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时,让你可以在浏览器之外执行 JavaScript 代码。
npm(Node Package Manager)是 Node.js 的包管理工具,随 Node.js 一同安装。它让你可以方便地下载、安装和管理项目依赖——比如 React、Vue、Next.js 等框架,都是通过 npm 来安装的。
简单来说:装 Node.js = 同时装了 npm。
二、Windows 安装
方法一:官方安装包(推荐)
- 访问 Node.js 官网
- 点击首页左侧的 LTS(长期支持版)下载按钮
- 运行下载的
.msi安装程序 - 一路点击 Next,保持默认选项即可
- 安装完成后,点击 Finish
方法二:使用包管理器
如果你已经安装了 Winget(Windows 10/11 自带),可以在 PowerShell 中运行:
winget install OpenJS.NodeJS.LTS或者使用 Chocolatey:
choco install nodejs-lts三、macOS 安装
方法一:官方安装包
- 访问 Node.js 官网
- 下载 LTS 版本的
.pkg文件 - 双击运行,按提示完成安装
方法二:Homebrew(推荐)
如果你使用 Homebrew,一行命令即可:
brew install node@22注意:Homebrew 安装的版本可能较新。如果需要特定版本,可以使用
brew install node@20等形式。
方法三:版本管理器 fnm
对于需要在多个 Node.js 版本之间切换的开发者,推荐使用 fnm:
# 安装 fnm
curl -fsSL https://fnm.vercel.app/install | bash
# 安装并使用最新的 LTS 版本
fnm install --lts
fnm use --lts四、Linux 安装
Ubuntu / Debian
# 更新软件源
sudo apt update
# 安装 Node.js 和 npm
sudo apt install -y nodejs npm
# 注意:系统源中的版本可能较旧,建议后续使用 n 或 nvm 升级如需最新版本,可以使用 NodeSource 脚本:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejsCentOS / RHEL / Fedora
# 使用 NodeSource
sudo dnf install https://rpm.nodesource.com/pub_22.x/nodistro/repo/nodesource-release-nodistro-1.noarch.rpm
sudo dnf install -y nodejs --setopt=nodesource-nodejs.module_hotfixes=1Arch Linux
sudo pacman -S nodejs npm五、验证安装
打开终端(Windows 使用 PowerShell 或 CMD,macOS/Linux 使用 Terminal),输入以下命令:
node -v
npm -v如果看到类似下面的输出,说明安装成功:
v22.14.0
10.9.2
版本号可能与你安装时略有不同,只要没有报错即可。
六、配置国内镜像源(可选)
由于网络原因,国内访问 npm 官方仓库可能较慢。可以配置淘宝镜像源加速下载:
临时使用
npm install <package-name> --registry=https://registry.npmmirror.com永久配置
npm config set registry https://registry.npmmirror.com验证配置
npm config get registry如果后续需要恢复到官方源,运行:
npm config set registry https://registry.npmjs.org/
七、常见问题
1. 'node' 不是内部或外部命令
原因:Node.js 没有正确添加到系统环境变量。
解决:
- Windows:重新安装 Node.js,确保勾选了 "Add to PATH" 选项
- 或手动将
C:\Program Files\nodejs\添加到系统环境变量 Path 中
2. npm install 速度极慢或超时
原因:网络连接 npm 官方仓库不稳定。
解决:配置国内镜像源(见上文第六节)。
3. EACCES: permission denied
原因:macOS/Linux 上使用 sudo npm install -g 导致权限问题。
解决:
- 避免使用
sudo安装全局包 - 或者修改 npm 全局目录的权限:
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc4. 如何升级 npm
npm install -g npm@latest八、下一步
安装完成后,你可以尝试创建一个简单的项目来熟悉 npm:
# 创建项目目录
mkdir my-first-project
cd my-first-project
# 初始化项目(会生成 package.json)
npm init -y
# 安装一个包试试
npm install lodash恭喜你,Node.js 和 npm 已经准备就绪,可以开始你的开发之旅了!