Node.js 版本管理（nvm）和 npm 入门

为什么需要 nvm？

不同的项目可能依赖不同版本的 Node.js。比如老项目用 Node 16，新项目用 Node 20。手动管理版本很痛苦——卸载、重装、改环境变量……

nvm（Node Version Manager）就是解决这个问题的：一行命令切换 Node.js 版本，不同项目互不干扰。

安装 nvm

macOS / Linux 一行命令搞定：

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

安装完成后，重启终端，或者手动加载：

source ~/.zshrc

验证安装成功：

nvm --version
# 输出类似：0.40.1

Windows 用户请使用 nvm-windows，安装时建议将安装目录改到 D:\Program\nvm，避免占用 C 盘空间。命令略有不同。

安装 Node.js

安装最新的 LTS（长期支持）版本：

nvm install --lts

安装指定版本：

nvm install 20

查看已安装的版本：

nvm ls
# ->       v20.18.0
#           system
# default -> 20 (-> v20.18.0)

切换版本

切换到已安装的版本：

nvm use 20

设置默认版本（新终端自动使用）：

nvm alias default 20

切换到系统自带的 Node.js（如果有的话）：

nvm use system

npm 基础

安装 Node.js 时会自动带上 npm（Node Package Manager），用来安装和管理项目依赖。

初始化项目

mkdir my-project && cd my-project
npm init -y

这会生成一个 package.json 文件，记录项目的名称、版本、依赖等信息。

安装依赖

安装一个包（添加到 dependencies）：

npm install express

安装开发依赖（只在开发时用，比如代码检查工具）：

npm install -D eslint

安装全局工具（命令行工具，所有项目都能用）：

npm install -g typescript

常用命令速查

# 查看已安装的包
npm ls

# 更新所有依赖到最新版本
npm update

# 卸载包
npm uninstall lodash

# 运行 package.json 中定义的脚本
npm run dev
npm run build

npm 换源

国内访问 npm 官方源很慢，推荐换用淘宝镜像：

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

验证：

npm config get registry
# https://registry.npmmirror.com

推荐：用 pnpm 替代 npm

如果你开始做稍微大一点的项目，推荐试试 pnpm——更快、更省磁盘空间：

npm install -g pnpm

用法和 npm 几乎一样：

pnpm install express
pnpm run dev

小结

工具	作用
nvm	管理多个 Node.js 版本
npm	安装和管理项目依赖
pnpm	npm 的更快替代品

配置好环境后，下一步就是创建你的第一个 Node.js 项目了。