Node.js 介绍与环境配置

一、什么是 Node.js

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境，可以让 JavaScript 在服务端运行。

为什么介绍Nodejs？*

nodejs有优秀的 跨平台、易安装的特性。现在的AI终端工具（以及openclaw）都是基于Nodejs 开发。掌握Nodejs 基础，有益于在安装的时候排错。

主要特点

• 事件驱动 - 采用事件驱动、非阻塞 I/O 模型
• 单线程 - JavaScript 执行是单线程的，但底层通过 libuv 实现多线程 IO
• 跨平台 - 支持 Windows、macOS、Linux 等多种操作系统

应用场景

• Web 服务器开发（Express、Koa、Nest.js）
• 前端构建工具（Webpack、Vite、Rollup）
• 命令行工具（CLI）开发 （claude code/ datax / ）
• 实时应用（WebSocket、聊天应用）

二、Node.js 跨平台特性

跨平台优势

Node.js 基于 libuv 库实现跨平台，同一套代码可以在不同操作系统上运行。

Node.js 缺点*

版本上下兼容差，如果要运行多个不同版本的nodejs项目，建议安装版本管理器。

安装方式（不推荐直接安装）

Windows 安装

略

macOS 安装

方式一：官网 pkg 安装

# 同 Windows，下载 pkg 安装包即可

方式二：Homebrew 安装（推荐）

brew install node

Linux 安装

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL
sudo yum install nodejs npm

三、包管理器介绍

Node.js 生态有多个包管理器，各有优缺点。包管理类似于python的pip *

1. npm（Node Package Manager）

npm 是 Node.js 官方自带的包管理器，安装 Node.js 时自动安装。

常用命令：

# 初始化项目
npm init
npm init -y  # 快速初始化，使用默认配置

# 安装依赖
npm install <package-name>      # 本地安装
npm install -g <package-name>   # 全局安装
npm install <package-name> --save-dev  # 开发依赖

# 卸载依赖
npm uninstall <package-name>

# 更新依赖
npm update <package-name>

# 运行脚本
npm run <script-name>

# 查看已安装包
npm list
npm list -g --depth=0  # 查看全局安装的顶层包

2. pnpm（Performant npm）

pnpm 是一个快速、节省磁盘空间的包管理器。

特点：

• 利用硬链接和符号链接节省磁盘空间
• 安装速度比 npm 快 2-3 倍
• 严格的依赖管理，避免幽灵依赖

安装方式：

# 使用 npm 安装
npm install -g pnpm

# 或者使用官方脚本
curl -fsSL https://get.pnpm.io/install.sh | sh

常用命令：

pnpm install <package-name>   # 安装
pnpm add <package-name>       # 同上
pnpm add -D <package-name>    # 开发依赖
pnpm remove <package-name>    # 卸载
pnpm update                    # 更新
pnpm list                      # 查看

3. Yarn

Yarn 是 Facebook 推出的包管理器，注重安全性和稳定性。

安装方式：

npm install -g yarn

常用命令：

yarn init                    # 初始化
yarn add <package-name>      # 安装
yarn add --dev <package-name>
yarn remove <package-name>
yarn upgrade <package-name>
yarn list

包管理器对比*

推荐使用场景：

• 新项目：推荐使用 pnpm
• 大型 monorepo：推荐使用 pnpm 或 yarn berry
• 老项目：保持原有的包管理器

四、NVM - Node.js 版本管理器*

在实际开发中，不同项目可能需要不同版本的 Node.js，这时候就需要版本管理工具了！

官方仓库 nvm-sh/nvm: Node Version Manager - POSIX-compliant bash script to manage multiple active node.js versions

什么是 NVM

NVM（Node Version Manager）可以让你在同一台机器上安装和切换多个 Node.js 版本。

Windows 系统：使用 nvm-windows

安装步骤：

1. 访问 https://github.com/coreybutler/nvm-windows/releases
2. 下载最新的 nvm-setup.exe 安装包
3. 双击运行安装程序
4. 安装完成后重启终端

macOS / Linux 系统：使用 nvm

安装步骤：（仅供参考，建议安装官方仓库教程安装）

# 使用 curl 安装
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

# 或者使用 wget 安装
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

安装完成后，重新加载终端配置：

source ~/.bashrc
# 或
source ~/.zshrc

使用教程：

# 验证安装
nvm --version

# 查看可安装的 LTS 版本
nvm ls-remote --lts

# 安装 Node.js
nvm install 24
nvm install --lts

# 查看已安装版本
nvm ls

# 切换版本
nvm use 24

# 设置默认版本
nvm alias default 24

# 卸载版本
nvm uninstall 16.0.0

项目级版本控制

在项目根目录创建 .nvmrc 文件，指定项目所需的 Node.js 版本：

# 在项目根目录创建 .nvmrc
echo "18.18.0" > .nvmrc

团队成员进入项目时，只需运行：

nvm use  # 自动切换到 .nvmrc 指定的版本

五、常用命令速查表

七、常见问题排查

Q: 安装包时权限错误？

A: Windows 以管理员身份运行终端；macOS/Linux 使用 sudo 或配置 npm 使用用户目录。

Q: node 命令找不到？

A: 检查环境变量 PATH，确认 Node.js 安装路径已添加。

Q: 切换 Node.js 版本后不生效？

A: 重启终端，或检查是否有其他版本管理工具冲突。