六维教程

Node.js 环境搭建

Node.js 版本选择

Node.js 官方提供 LTS(长期支持)Current(最新) 两个版本:

版本类型 特点 推荐场景
LTS 稳定、维护周期长、经过充分测试 生产项目、学习(推荐)
Current 包含最新特性、更新频繁 尝鲜、测试新功能

建议选择 LTS 版本,Node.js 偶数版本号(如 18.x、20.x)为 LTS 版本。

Node.js 安装方式

方式一:官方安装包(推荐新手)

这是最直接的方式,访问 nodejs.org 下载对应操作系统的安装包即可。

Windows 安装步骤

  1. 访问 nodejs.org,点击 LTS 版本下载 .msi 安装包
  2. 双击安装包,按向导提示逐步安装
  3. 安装程序会自动将 Node.js 添加到系统 PATH,无需手动配置
  4. 安装完成后,重启终端(重要),然后验证安装

macOS 安装步骤

  1. 访问 nodejs.org,点击 LTS 版本下载 .pkg 安装包
  2. 双击安装包,按向导提示逐步安装
  3. 安装完成后验证

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
上一篇
Node.js 是什么
下一篇
Node.js 第一个程序