Node.js 环境搭建
Node.js 版本选择
Node.js 官方提供 LTS(长期支持) 和 Current(最新) 两个版本:
| 版本类型 | 特点 | 推荐场景 |
|---|---|---|
| LTS | 稳定、维护周期长、经过充分测试 | 生产项目、学习(推荐) |
| Current | 包含最新特性、更新频繁 | 尝鲜、测试新功能 |
建议选择 LTS 版本,Node.js 偶数版本号(如 18.x、20.x)为 LTS 版本。
Node.js 安装方式
方式一:官方安装包(推荐新手)
这是最直接的方式,访问 nodejs.org 下载对应操作系统的安装包即可。
Windows 安装步骤
- 访问 nodejs.org,点击 LTS 版本下载
.msi安装包 - 双击安装包,按向导提示逐步安装
- 安装程序会自动将 Node.js 添加到系统 PATH,无需手动配置
- 安装完成后,重启终端(重要),然后验证安装
macOS 安装步骤
- 访问 nodejs.org,点击 LTS 版本下载
.pkg安装包 - 双击安装包,按向导提示逐步安装
- 安装完成后验证
Linux 安装步骤
Node.js 官方提供了针对各 Linux 发行版的安装脚本:
# 使用 NodeSource 提供的安装脚本(以 Ubuntu/Debian 为例)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
# 或使用官方二进制包(通用方式)
# 下载、解压、添加到 PATH
方式二:包管理器安装
不同操作系统可以通过各自的包管理器安装 Node.js:
| 操作系统 | 包管理器 | 命令 |
|---|---|---|
| macOS | Homebrew | brew install node |
| Ubuntu/Debian | apt | sudo apt install nodejs npm |
| CentOS/RHEL | yum | sudo yum install nodejs npm |
| Windows | winget | winget install OpenJS.NodeJS |
# macOS 示例
brew install node
# Ubuntu 示例(注意:apt 仓库版本可能较旧,建议使用官方脚本)
sudo apt update
sudo apt install nodejs npm
注意:系统包管理器的仓库版本可能滞后,如果版本过低(低于 16.x),建议使用官方安装包或 nvm。
配置 npm 镜像(国内加速)
国内用户安装依赖时可能遇到网络慢的问题,建议配置 npm 镜像源:
# 查看当前镜像源
npm config get registry
# 设置为淘宝镜像源(国内推荐)
npm config set registry https://registry.npmmirror.com
验证环境
无论使用哪种方式安装,安装完成后都需要验证环境是否可用。
# 查看 Node.js 版本
node -v
# 输出类似 v20.12.0
# 查看 npm 版本(Node.js 自带包管理器)
npm -v
# 输出类似 10.5.0
# 查看 npx 版本
npx -v
# 输出类似 10.5.0
如果以上命令都能正常输出版本号,说明环境已成功安装。
运行第一个 Node.js 程序
创建一个 hello.js 文件:
// hello.js
console.log("Hello, Node.js!");
const sum = (a, b) => a + b;
console.log(`1 + 2 = ${sum(1, 2)}`);
在终端中运行:
node hello.js
# 输出:
# Hello, Node.js!
# 1 + 2 = 3