2. 安装 Node.js

本节目标：在自己的电脑上装好 Node.js，搞清楚 LTS 和 Current 的区别，装完后验证一切正常。

选哪个版本

打开 nodejs.org，你会看到两个下载按钮：

LTS（长期支持版）：推荐绝大多数用户，尤其是生产环境。当前是 v24 LTS（代号 Krypton）。
Current（最新特性版）：想尝鲜就用这个，当前是 v26.5.0。

Tip

新手直接装 LTS。Current 里的新特性你可能暂时用不上，反而可能遇到工具链兼容问题。等过几个月 Current 进入 LTS，再升级也不迟。

怎么判断你现在的项目该用哪个？看 package.json 里的 engines 字段，或者问问 team 里有没有版本约定。没有的话，LTS 永远是最安全的选择。

Windows 安装

方法一：官方安装包（推荐新手）

去官网下载 .msi 安装包，选 LTS 版。
双击运行，一路 Next。安装程序会自动把 Node.js 和 npm 加到系统 PATH 里。
装完打开 PowerShell 或 CMD，输入：

node -v
npm -v

看到版本号跳出来，就成功了。

Warning

安装过程中有个「Add to PATH」的复选框，默认是勾上的，别手贱取消掉。不然装完后命令行找不到 node，还得手动配环境变量，痛苦加倍。

方法二：winget（命令行党）

Windows 10/11 自带包管理器，一行搞定：

winget install OpenJS.NodeJS.LTS

装完记得重启终端，不然 PATH 没刷新，敲 node 还是报找不到命令。

方法三：二进制压缩包

不想写注册表、不想用安装向导？下载 .zip 版，解压到某个目录（比如 D:\nodejs），然后手动把目录加到 PATH。适合喜欢掌控一切的选手。

macOS 安装

方法一：官方安装包

下载 .pkg 文件，双击安装。最简单，零配置。

方法二：Homebrew

brew install node@22

注意 Homebrew 默认可能装的是 Current 或者最新可获得的版本。如果你想锁定 LTS，可以：

brew install node

然后手动 brew link node。

验证

node -v
npm -v

Linux 安装

不同发行版路线不同，别从网上复制一条 apt install nodejs 就完事——很多系统源里的 Node.js 版本老得掉牙。

Ubuntu / Debian

用 NodeSource 源，能拿到最新版：

curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

CentOS / RHEL / Fedora

curl -fsSL https://rpm.nodesource.com/setup_24.x | sudo bash -
sudo yum install -y nodejs

Arch Linux

sudo pacman -S nodejs npm

Arch 的仓库更新快，通常能拿到很新的版本。

通用方法：直接解压二进制

不想折腾包管理器？去官网下载 linux-x64.tar.xz，解压即用：

wget https://nodejs.org/dist/v24.18.0/node-v24.18.0-linux-x64.tar.xz
tar -xf node-v24.18.0-linux-x64.tar.xz
sudo mv node-v24.18.0-linux-x64 /usr/local/lib/nodejs

然后手动把 bin 目录加到 PATH（写到 ~/.bashrc 或 ~/.zshrc）：

export PATH=/usr/local/lib/nodejs/bin:$PATH

装完必做的三件事

1. 确认版本

node -v      # 期望输出 v24.x.x 或更高
npm -v       # 期望输出 10.x.x 或更高

如果提示 command not found，九成是 PATH 没配好。Windows 用户试试重启终端或电脑；macOS/Linux 用户检查 ~/.bashrc / ~/.zshrc。

2. 改 npm 全局安装路径（可选但强烈建议）

npm 全局装包时，默认会往系统目录写文件。在 Linux/macOS 上可能要 sudo，在 Windows 上可能要管理员权限。长期这样很烦。

改到自己用户目录下：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'

然后把 ~/.npm-global/bin 加到 PATH。以后全局装包再也不需要 sudo。

3. 换国内镜像（国内用户）

npm 默认 registry 在国外，安装依赖时可能慢得像蜗牛。淘宝镜像或者 npmmirror 都能救你：

npm config set registry https://registry.npmmirror.com

验证：

npm config get registry

Note

换镜像只对 npm install 下载包的速度有帮助，不影响你写代码。 team 项目里如果有 package-lock.json，大家尽量用同一个 registry，避免 lock 文件哈希对不上。

多版本管理预告

你可能想问：「我能不能同时装 v22 和 v24，按项目切换？」

能，而且你应该这么做。下一章专门讲 NVM 和完整的开发环境搭建，包括 VS Code 配置和调试。如果你现在急着用，Windows 用户可以先去 github.com/coreybutler/nvm-windows 装个 nvm-windows，macOS/Linux 用户装 nvm-sh/nvm。

常见问题速查

Q: node 命令找不到

Windows：安装时没勾选 PATH，或者终端没重启。去系统环境变量里加 C:\Program Files\nodejs。
macOS/Linux：source ~/.bashrc 或重新打开终端。

Q: npm install 报错 permission denied

别用 sudo npm install。按上面的步骤改 npm prefix，或者局部安装（在项目目录里不加 -g）。

Q: 公司内网装不了

配代理：npm config set proxy http://公司代理:端口
或者换能访问的 registry，甚至自建私有 registry（如 Verdaccio）。

现在你的电脑上已经有 Node.js 了。下一章我们搭一个顺手的开发环境。