使用 fnm 安装 Node.js
fnm 让安装和管理 Node.js 版本变得简单快捷。本指南将详细介绍如何使用 fnm 安装 Node.js。
快速开始
安装最新 LTS 版本
bash
fnm install --lts安装最新版本
bash
fnm install --latest安装指定版本
bash
fnm install 20
fnm install 18.17.0安装方式详解
安装 LTS 版本
Node.js LTS（长期支持）版本推荐用于生产环境：
bash
# 安装最新 LTS 版本
fnm install --lts
# 安装指定 LTS 版本
fnm install lts/iron # Node.js 20.x
fnm install lts/hydrogen # Node.js 18.x
fnm install lts/gallium # Node.js 16.xLTS 版本代号对照表：
| 代号 | 版本 | 状态 |
|---|---|---|
| Iron | 20.x | Active LTS |
| Hydrogen | 18.x | Maintenance |
| Gallium | 16.x | End of Life |
安装特定版本
bash
# 安装主版本（自动选择最新的次版本）
fnm install 20
# 安装特定版本
fnm install 20.10.0
# 安装旧版本
fnm install 14.21.3使用版本文件安装
在项目目录中创建 .node-version 或 .nvmrc 文件：
bash
# 创建 .node-version 文件
echo "20" > .node-version
# fnm 会自动读取并安装
fnm install安装后使用
切换到已安装版本
bash
# 使用指定版本
fnm use 20
# 如果版本未安装，自动安装后使用
fnm use 18 --install-if-missing设置默认版本
bash
# 设置默认版本
fnm default 20
# 查看当前默认版本
fnm default安装后立即使用
bash
# 安装并立即切换到该版本
fnm install 20 --use查看可用版本
查看远程版本
bash
# 列出所有可用版本
fnm list-remote
# 只列出 LTS 版本
fnm list-remote --lts
# 过滤特定版本
fnm list-remote --filter=18
# 查看最新版本
fnm list-remote --latest查看本地已安装版本
bash
fnm list输出示例：
* v20.10.0 default
v18.19.0
v16.20.2使用镜像加速
在中国大陆，可以使用镜像加速下载：
bash
# 设置镜像环境变量
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node
# 或者在安装时指定
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node常用镜像：
| 镜像源 | 地址 |
|---|---|
| npmmirror | https://npmmirror.com/mirrors/node |
| 清华大学 | https://mirrors.tuna.tsinghua.edu.cn/nodejs-release |
Corepack 支持
fnm 支持 Corepack，可以自动启用 Yarn 和 pnpm：
bash
# 安装时启用 Corepack
fnm install 20 --corepack-enabled
# 或设置环境变量
export FNM_COREPACK_ENABLED=true
fnm install 20版本管理最佳实践
项目级版本管理
在项目根目录创建 .node-version 文件：
bash
# 指定主版本
echo "20" > .node-version
# 或指定精确版本
echo "20.10.0" > .node-version配合 --use-on-cd 选项，进入目录时自动切换版本：
bash
# 在 Shell 配置中添加
eval "$(fnm env --use-on-cd)"多版本开发
bash
# 安装多个版本
fnm install 20
fnm install 18
fnm install 16
# 在不同项目间切换
cd project-a && fnm use 20
cd project-b && fnm use 18使用别名
bash
# 设置别名
fnm alias 20 default
fnm alias 18 legacy
# 使用别名切换
fnm use default
fnm use legacy常见问题
安装失败
如果安装失败，请检查：
- 网络连接是否正常
- 是否需要配置镜像
- 磁盘空间是否充足
bash
# 使用镜像重试
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node版本切换不生效
确保已正确配置 Shell：
bash
# 检查当前版本
fnm current
# 检查 node 路径
which node清理旧版本
bash
# 查看已安装版本
fnm list
# 卸载不需要的版本
fnm uninstall 16.20.2