Windows 和 Ubuntu 双系统下 Node.js 安装全攻略：从新手到熟练

Node.js 作为 JavaScript 运行环境，已经成了前端开发、后端服务、工具脚本的标配。不管你是 Windows 用户还是 Ubuntu 用户，装好 Node 都能直接跑 npm、yarn、pnpm 这些包管理器，搭 Vue、React、Express 项目也更顺手。很多新手卡在安装这一步，要么版本太旧，要么路径冲突，要么权限报错。下面按 Windows 和 Ubuntu 两条线，把常见安装方式、验证方法和避坑点一次性讲清楚，适合纯小白跟着做，也方便进阶用户选高效方案。

一、安装前先搞清楚这几件事

Node.js 当前主流是 LTS 长期支持版，稳定性优先就选它。官网地址是 nodejs.org，打开就能看到推荐版本。安装完后建议再配一个版本管理工具，方便切换 16、18、20 这些大版本，避免项目依赖冲突。

系统要求简单：Windows 10/11 64 位即可，Ubuntu 建议 20.04 及以上。磁盘预留 500MB 以上空间。装之前先关掉杀毒软件的实时防护，减少拦截。装完用 node -v 和 npm -v 验证，能输出版本号就说明成功。

二、Windows 系统安装 Node.js

Windows 用户最省事的是官网安装包，想灵活切换版本就用 nvm-windows。

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

打开浏览器访问 nodejs.org，首页直接点绿色的 LTS 按钮下载 Windows 安装包（.msi 文件）。
双击下载好的文件，一路点“下一步”。注意勾选“Automatically install the necessary tools”，这样会顺带装上 Python 和构建工具，后面编译原生模块时少踩坑。
安装路径默认在 C:\Program Files\nodejs，可以改到 D 盘，但路径里别带中文和空格。
完成后打开命令提示符（Win + R 输入 cmd），输入：
```
node -v
npm -v
```
如果显示 v20.x.x 和对应的 npm 版本，就成功了。

有时环境变量没生效，关掉所有命令行窗口重新开一个再试。还不行就手动把安装目录加到系统 Path 里：右键“此电脑”→属性→高级系统设置→环境变量→系统变量里的 Path→新建→粘贴 nodejs 路径。

方法二：用 nvm-windows 管理多版本（推荐进阶）

官网直装只能装一个版本，项目多了就容易冲突。nvm-windows 可以一键切换。

去 GitHub 搜索 nvm-windows，下载最新 release 里的 nvm-setup.exe。
安装时选一个非系统盘路径，比如 D:\nvm 和 D:\nodejs。
安装完成后新开 PowerShell 或 cmd，输入：
```
nvm list available
```
看可下载版本。然后装 LTS：
```
nvm install 20.11.0
nvm use 20.11.0
```
验证：
```
nvm list
node -v
```
当前激活的版本前会有 * 号。

想装淘宝镜像加速下载，可以设：

nvm node_mirror https://npmmirror.com/mirrors/node/
nvm npm_mirror https://npmmirror.com/mirrors/npm/

Windows 常见问题处理

提示“不是内部或外部命令”：多半是 Path 没刷新，重启电脑或重新打开终端。
权限不足：用管理员身份运行安装程序。
旧版本残留：去控制面板卸载 Node.js，再删掉残留的 nodejs 文件夹和用户目录下的 .npmrc。

装完建议全局装一个常用工具：

npm install -g yarn pnpm

三、Ubuntu 系统安装 Node.js

Ubuntu 下 apt 源里的 Node 版本通常偏旧，生产环境不建议直接用。优先用 NodeSource 或 nvm。

方法一：NodeSource 仓库安装（稳定快速）

适合只想装一个固定版本的用户。

打开终端，先更新软件源：

sudo apt update
sudo apt install -y curl

添加 NodeSource 仓库（以 20.x 为例）：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

安装：
```
sudo apt install -y nodejs
```
验证：
```
node -v
npm -v
```

想装构建工具（node-gyp 需要）：

sudo apt install -y build-essential

方法二：nvm 安装（最推荐，跨系统通用）

nvm 在 Ubuntu 上体验和 Windows 几乎一样，切换版本零压力。

安装 nvm：

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

让配置生效（或者直接关掉终端重新打开）：
```
source ~/.bashrc
```

查看可用版本并安装：

nvm ls-remote
nvm install --lts
nvm use --lts

设置默认版本：
```
nvm alias default node
```
验证：
```
node -v
which node
```

国内网络慢的话，可以改镜像：

export NVM_NODEJS_ORG_MIRROR=https://npmmirror.com/mirrors/node
nvm install 20

方法三：snap 快速安装

Ubuntu 自带 snap，一行命令搞定：

sudo snap install node --classic

验证同样用 node -v。snap 版本更新及时，但路径在 /snap/bin，有时和系统工具冲突，不适合深度定制。

Ubuntu 权限与路径注意点

不要用 sudo npm install -g，容易把全局包装到 root 下，权限一团乱。nvm 装的 Node 默认在用户目录，没有这个问题。
如果已经用 apt 装过旧版，先卸载：
```
sudo apt remove nodejs npm
sudo apt autoremove
```
终端提示 nvm 命令找不到：检查 ~/.bashrc 或 ~/.zshrc 末尾有没有 nvm 的 source 语句，没有就手动加：
```
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
```

四、安装后统一优化建议

无论 Windows 还是 Ubuntu，装完都可以做这几步提升体验：

换国内 npm 镜像（加速下载）：

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

查看是否生效：

npm config get registry

解决全局包权限（Ubuntu 更常见）：如果不用 nvm，可以建一个用户目录下的全局路径：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

常用全局工具一次装齐：

npm install -g typescript ts-node nodemon pm2

项目里锁定版本：新建项目后记得写 .nvmrc 文件，内容就是版本号，比如 20，别人用 nvm use 就能对齐。

五、验证与基础测试

装完别急着关终端，跑个小测试确认环境正常：

创建测试文件：

echo "console.log('Node 安装成功，版本：' + process.version)" > test.js
node test.js

再试一下 npm：

npm init -y
npm install lodash

如果这两步都没报错，基本可以放心用了。

六、常见报错速查

Windows 下 npm 报错 EPERM：关掉占用 node 的程序，或者以管理员运行。
Ubuntu 下 gyp ERR!：缺编译工具，执行 sudo apt install build-essential python3。
版本对不上：用 nvm which current 看实际路径，确认没有多个 Node 混装。
网络超时：检查代理，或者临时关掉公司 VPN 再装。

Windows 适合图形界面操作，Ubuntu 更吃命令行。新手先官网直装或 NodeSource，等项目多了再上 nvm，切换成本几乎为零。装好 Node 后，前端脚手架、自动化脚本、简单后端服务都能立刻上手，后面再学 Docker 部署或服务器运维也更顺畅。按上面步骤走一遍，基本半小时内就能完成双系统环境搭建。