fnm install 命令详解

fnm install 命令用于安装新的 Node.js 版本。

命令语法

bash

fnm install [OPTIONS] [VERSION]

参数说明

VERSION

指定要安装的 Node.js 版本：

bash

# 安装主版本（自动选择最新次版本）
fnm install 20

# 安装特定版本
fnm install 20.10.0

# 安装 LTS 版本
fnm install lts/iron

# 不指定版本，读取版本文件
fnm install

选项说明

--lts

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

bash

fnm install --lts

--latest

安装最新版本（包括非 LTS）：

bash

fnm install --latest

--use

安装后立即切换到该版本：

bash

fnm install 20 --use

--progress

控制下载进度条显示：

bash

# 自动显示（默认）
fnm install 20 --progress=auto

# 始终显示
fnm install 20 --progress=always

# 从不显示
fnm install 20 --progress=never

--node-dist-mirror

指定 Node.js 下载镜像：

bash

fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

--arch

指定安装的架构：

bash

# 安装 x64 版本
fnm install 20 --arch=x64

# 安装 ARM64 版本
fnm install 20 --arch=arm64

--fnm-dir

指定 fnm 安装目录：

bash

fnm install 20 --fnm-dir=/custom/path

--log-level

设置日志级别：

bash

fnm install 20 --log-level=quiet
fnm install 20 --log-level=error
fnm install 20 --log-level=info

--corepack-enabled

启用 Corepack 支持：

bash

fnm install 20 --corepack-enabled

使用示例

安装 LTS 版本

bash

# 安装最新 LTS
fnm install --lts

# 安装指定 LTS 版本
fnm install lts/iron    # Node.js 20.x
fnm install lts/hydrogen # Node.js 18.x

安装特定版本

bash

# 安装主版本
fnm install 20

# 安装次版本
fnm install 20.10

# 安装精确版本
fnm install 20.10.0

安装并使用

bash

# 安装并立即切换
fnm install 20 --use

# 安装并设置为默认
fnm install 20 --use && fnm default 20

使用镜像加速

bash

# 使用国内镜像
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

安装特定架构

bash

# 在 Apple Silicon Mac 上安装 x64 版本
fnm install 20 --arch=x64

版本格式

fnm 支持多种版本格式：

格式	示例	说明
主版本	`20`	最新的 20.x.x
次版本	`20.10`	最新的 20.10.x
精确版本	`20.10.0`	精确版本
LTS 名称	`lts/iron`	LTS 版本代号
latest	`--latest`	最新版本

LTS 版本代号

代号	版本	发布日期
Iron	20.x	2023-10
Hydrogen	18.x	2022-10
Gallium	16.x	2021-10
Erbium	14.x	2020-10
Dubnium	12.x	2019-10

环境变量

可以通过环境变量配置默认行为：

bash

# 设置镜像
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

# 启用 Corepack
export FNM_COREPACK_ENABLED=true

# 设置安装目录
export FNM_DIR=~/.fnm

常见问题

安装失败

bash

# 尝试使用镜像
fnm install 20 --node-dist-mirror=https://npmmirror.com/mirrors/node

# 查看详细日志
fnm install 20 --log-level=info

版本已存在

bash

# 查看已安装版本
fnm list

# 使用已安装版本
fnm use 20

下载慢

bash

# 配置镜像
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node
fnm install 20

fnm install 命令详解 ​

命令语法 ​

参数说明 ​

VERSION ​

选项说明 ​

--lts ​

--latest ​

--use ​

--progress ​

--node-dist-mirror ​

--arch ​

--fnm-dir ​

--log-level ​

--corepack-enabled ​

使用示例 ​

安装 LTS 版本 ​

安装特定版本 ​

安装并使用 ​

使用镜像加速 ​

安装特定架构 ​

版本格式 ​

LTS 版本代号 ​

环境变量 ​

常见问题 ​

安装失败 ​

版本已存在 ​

下载慢 ​

相关链接 ​

fnm install 命令详解

命令语法

参数说明

VERSION

选项说明

--lts

--latest

--use

--progress

--node-dist-mirror

--arch

--fnm-dir

--log-level

--corepack-enabled

使用示例

安装 LTS 版本

安装特定版本

安装并使用

使用镜像加速

安装特定架构

版本格式

LTS 版本代号

环境变量

常见问题

安装失败

版本已存在

下载慢

相关链接