FNM 完全指南：快速高效的 Node.js 版本管理工具

WenHao 收录于技术教程

2025-10-22 约 2175 字预计阅读 5 分钟

FNM 完全指南：快速高效的 Node.js 版本管理工具

FNM（Fast Node Manager）是一个用 Rust 编写的现代化 Node.js 版本管理工具，以其快速的切换速度和跨平台支持而闻名。相比传统的版本管理工具，FNM 提供了更优的性能和更简洁的使用体验。

🚀 什么是 FNM？

FNM 是一个轻量级、高性能的 Node.js 版本管理器，具有以下特点：

核心优势

⚡ 极速切换：采用 Rust 编写，版本切换速度比传统工具快数倍
🌍 跨平台支持：完美支持 macOS、Linux 和 Windows
🔄 自动切换：支持进入项目目录时自动切换 Node.js 版本
📦 轻量级：安装包小，资源占用少
🛡️ 类型安全：Rust 的内存安全保证

与其他工具对比

特性	FNM	NVM	N
编写语言	Rust	Bash	Node.js
切换速度	🚀 极快	🐌 较慢	🚀 快
跨平台	✅ 完全支持	⚠️ Windows 有限	✅ 完全支持
自动切换	✅ 支持	✅ 支持	✅ 支持
安装大小	📦 小	📦 中	📦 大

📦 安装 FNM

1. macOS / Linux 系统

使用 Homebrew（推荐）

        
# 安装 FNM
brew install fnm

# 验证安装
fnm --version

使用安装脚本（跨平台）

        
# 下载并安装 FNM
curl -fsSL https://fnm.vercel.app/install | bash

# 自定义安装选项
curl -fsSL https://fnm.vercel.app/install | bash -s -- --skip-shell
curl -fsSL https://fnm.vercel.app/install | bash -s -- --install-dir=/custom/path

2. Windows 系统

使用 winget

        
# 通过 winget 安装
winget install Schniz.fnm

# 验证安装
fnm --version

使用 Scoop

        
# 通过 Scoop 安装
scoop install fnm

⚙️ Shell 环境配置

Bash 配置

        
# 添加到 ~/.bashrc
echo 'eval "$(fnm env --use-on-cd --shell bash)"' >> ~/.bashrc

# 重新加载配置
source ~/.bashrc

Zsh 配置

        
# 添加到 ~/.zshrc
echo 'eval "$(fnm env --use-on-cd --shell zsh)"' >> ~/.zshrc

# 重新加载配置
source ~/.zshrc

Fish 配置

        
# 添加到 ~/.config/fish/config.fish
echo 'fnm env --use-on-cd --shell fish | source' >> ~/.config/fish/config.fish

PowerShell 配置

        
# 添加到 PowerShell Profile
fnm env --use-on-cd --shell powershell | Out-String | Invoke-Expression

# 或者添加到 profile 文件
Add-Content -Path $PROFILE -Value 'fnm env --use-on-cd --shell powershell | Out-String | Invoke-Expression'

🔧 环境变量配置

常用环境变量

        
# 自定义 FNM 安装目录
export FNM_DIR="$HOME/.fnm"

# 设置 Node.js 下载镜像源（提高下载速度）
export FNM_NODE_DIST_MIRROR="https://npmmirror.com/mirrors/node/"

# 设置远程版本列表缓存时间（秒）
export FNM_REMOTE_VERSIONS_CACHE_DURATION=86400

国内镜像配置

        
# 使用淘宝镜像加速下载
export FNM_NODE_DIST_MIRROR="https://npmmirror.com/mirrors/node/"

# 或者使用腾讯云镜像
export FNM_NODE_DIST_MIRROR="https://mirrors.cloud.tencent.com/nodejs-release/"

📋 基本使用命令

版本管理命令

        
        
        
    
# 列出所有可安装的远程版本
fnm list-remote

# 列出所有 LTS 版本
fnm list-remote --lts

# 安装最新 LTS 版本
fnm install --lts

# 安装指定主版本
fnm install 18

# 安装完整版本号
fnm install 18.21.1

# 安装最新版本
fnm install latest

# 列出本地已安装的版本
fnm list

# 查看当前使用的版本
fnm current

版本切换命令

        
# 切换到指定版本（当前会话）
fnm use 18

# 设置默认版本
fnm default 18

# 切换到最新版本
fnm use latest

# 切换到最新 LTS 版本
fnm use --lts

版本卸载命令

        
# 卸载指定版本
fnm uninstall 18.21.1

# 卸载当前版本
fnm uninstall $(fnm current)

# 批量卸载所有版本（Linux/macOS）
fnm list | awk -F' ' 'NR>1 {print $2}' | xargs -n1 fnm uninstall

🏷️ 别名管理

创建和使用别名

        
# 为版本创建别名
fnm alias 18.21.1 lts-hydrogen

# 为最新 LTS 创建别名
fnm alias $(fnm current --lts) lts

# 使用别名切换版本
fnm use lts-hydrogen

# 设置默认别名
fnm default lts-hydrogen

管理别名

        
# 列出所有别名
fnm aliases

# 删除别名
fnm unalias lts-hydrogen

# 为多个版本创建别名
fnm alias 18.21.1 stable-18
fnm alias 20.12.2 stable-20

📁 项目级版本管理

使用 .node-version 文件

        
# 在项目根目录创建 .node-version 文件
echo "18.21.1" > .node-version

# 或者使用 FNM 命令创建
fnm use 18.21.1 --save

使用 .nvmrc 文件

        
# 创建 .nvmrc 文件（与 NVM 兼容）
echo "18.21.1" > .nvmrc

# FNM 会自动识别 .nvmrc 文件

在 package.json 中指定版本

        
        
        
    
{
  "name": "my-project",
  "version": "1.0.0",
  "engines": {
    "node": ">=18.0.0",
    "npm": ">=8.0.0"
  },
  "volta": {
    "node": "18.21.1"
  }
}

自动切换功能

        
# 启用进入目录时自动切换版本
fnm use 18.21.1 --save-if-exists

# 在 shell 配置中已包含 --use-on-cd 参数
# 进入项目目录时会自动切换到指定版本
cd ~/my-project
# FNM 会自动检测并切换到 .node-version 或 .nvmrc 中指定的版本

🔄 高级使用技巧

批量操作

        
# 安装多个版本
for version in 16 18 20; do
  fnm install $version
done

# 批量卸载旧版本
fnm list | grep -E "v(14|16|17)" | awk '{print $2}' | xargs -n1 fnm uninstall

脚本化使用

        
        
        
    
#!/bin/bash
# 自动选择最佳 Node.js 版本的脚本

PROJECT_VERSION_FILE=".node-version"
if [ -f "$PROJECT_VERSION_FILE" ]; then
  REQUIRED_VERSION=$(cat "$PROJECT_VERSION_FILE")
  echo "项目需要 Node.js 版本: $REQUIRED_VERSION"
  
  if ! fnm list | grep -q "$REQUIRED_VERSION"; then
    echo "安装所需版本..."
    fnm install "$REQUIRED_VERSION"
  fi
  
  fnm use "$REQUIRED_VERSION"
  echo "已切换到版本: $(fnm current)"
else
  echo "未找到项目版本文件，使用默认 LTS 版本"
  fnm use --lts
fi

与其他工具集成

        
        
        
    
# 与 Docker 集成
FROM node:18-alpine
RUN curl -fsSL https://fnm.vercel.app/install | bash -s -- --install-dir=/opt/fnm
ENV PATH="/opt/fnm:${PATH}"
RUN fnm install 18 && fnm use 18

# 与 CI/CD 集成（GitHub Actions）
- name: Setup FNM
  run: |
    curl -fsSL https://fnm.vercel.app/install | bash
    echo 'eval "$(fnm env --use-on-cd --shell bash)"' >> ~/.bashrc
    source ~/.bashrc
    fnm install --lts
    fnm use --lts

🛠️ 卸载 FNM

macOS / Linux 卸载

        
        
        
    
# 1. 删除 FNM 安装目录
rm -rf ~/.local/share/fnm
# 或者如果使用了自定义目录
rm -rf ~/.fnm

# 2. 从 shell 配置中移除 FNM 配置
# 编辑 ~/.bashrc、~/.zshrc 等文件，删除以下行：
# eval "$(fnm env --use-on-cd --shell bash)"

# 3. 删除环境变量
unset FNM_DIR
unset FNM_NODE_DIST_MIRROR

# 4. 验证卸载
fnm --version  # 应该显示命令未找到

Windows 卸载

        
# 1. 使用 winget 卸载
winget uninstall Schniz.fnm

# 2. 手动删除安装目录
Remove-Item -Recurse -Force $env:LOCALAPPDATA\fnm

# 3. 从 PowerShell Profile 中移除配置
# 编辑 $PROFILE 文件，删除 FNM 相关配置

# 4. 删除环境变量
[Environment]::SetEnvironmentVariable("FNM_DIR", $null, "User")
[Environment]::SetEnvironmentVariable("FNM_NODE_DIST_MIRROR", $null, "User")

🔍 常见问题解决

下载速度慢

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

# 或者使用腾讯云镜像
export FNM_NODE_DIST_MIRROR="https://mirrors.cloud.tencent.com/nodejs-release/"

版本切换不生效

        
# 重新加载 shell 配置
source ~/.zshrc  # 或 ~/.bashrc

# 手动执行环境加载
eval "$(fnm env --use-on-cd --shell zsh)"

# 检查当前版本
fnm current
node --version

VS Code 终端版本问题

        
        
        
    
// VS Code settings.json
{
  "terminal.integrated.profiles.osx": {
    "zsh": {
      "path": "/bin/zsh",
      "args": ["-l"]
    }
  },
  "terminal.integrated.defaultProfile.osx": "zsh"
}

权限问题

        
# 修复 FNM 目录权限
chmod 755 ~/.local/share/fnm
chmod -R 644 ~/.local/share/fnm/node-versions

# 或者更改安装目录到用户主目录
export FNM_DIR="$HOME/fnm"

📊 性能优化

缓存配置

        
# 设置版本列表缓存时间（默认 1 小时）
export FNM_REMOTE_VERSIONS_CACHE_DURATION=86400  # 24 小时

# 清除缓存
fnm list-remote --clear-cache

并发安装

        
# 并行安装多个版本
fnm install 16 & fnm install 18 & fnm install 20 & wait

🎯 最佳实践

项目管理

始终使用版本文件：为每个项目创建 .node-version 文件
语义化版本：使用主版本号（如 18）而不是具体版本号
团队协作：将 .node-version 文件纳入版本控制

开发工作流

        
# 1. 克隆项目后
cd my-project

# 2. FNM 自动检测并切换版本
fnm current  # 显示项目所需版本

# 3. 验证环境
node --version
npm --version

# 4. 安装依赖
npm install

版本策略

        
        
        
    
# 开发环境：使用最新 LTS
fnm use --lts

# 生产环境：固定版本
fnm use 18.21.1

# 测试环境：多版本测试
for version in 16 18 20; do
  fnm use $version
  npm test
done

📚 相关资源

结语

FNM 作为一个现代化的 Node.js 版本管理工具，凭借其出色的性能和简洁的设计，为开发者提供了高效的版本管理体验。通过本文的详细介绍，你应该能够熟练掌握 FNM 的使用方法，在日常开发中提高工作效率。

无论是个人项目还是团队协作，FNM 都能帮助你轻松管理多个 Node.js 版本，确保开发环境的一致性和项目的可移植性。开始使用 FNM，让你的 Node.js 版本管理变得更加简单高效吧！