Node.js 环境安装指南

先检查是否已安装

打开终端，执行下面两条命令。如果能看到版本号，说明 Node.js 和 npm 已经可用。

node -v
npm -v

Windows

1. 前往 Node.js 官网下载 LTS 版本安装包。
2. 安装时保持默认选项，确保 npm 一起安装。
3. 打开新的 PowerShell 窗口，执行 node -v 和 npm -v。

macOS

如果你已经使用 Homebrew，可以直接安装 Node.js。

brew install node
node -v
npm -v

如果没有 Homebrew，也可以使用 Node.js 官网的 LTS 安装包。

Linux

Ubuntu / Debian 可以使用系统包管理器安装。生产或多版本开发环境建议使用 nvm、fnm 等版本管理工具。

sudo apt update
sudo apt install -y nodejs npm
node -v
npm -v

常见问题

• npm: command not found：npm 没有安装或终端没有重开。
• permission denied：不要随便给全局目录 chmod 777，优先使用 nvm/fnm 管理 Node。
• 安装后版本仍旧：关闭终端重新打开，或检查 PATH 顺序。