在 Linux 上安装 fnm

fnm 在 Linux 上有多种安装方式，本指南将帮助你在各种 Linux 发行版上安装 fnm。

安装方式

使用 curl 脚本（推荐）

最简单的安装方式：

curl -fsSL https://fnm.vercel.app/install | bash

安装后，按照提示重新加载 Shell 或手动添加到 PATH：

export PATH="$HOME/.fnm:$PATH"
eval "$(fnm env --use-on-cd)"

使用 Homebrew

如果你在 Linux 上安装了 Homebrew：

brew install fnm

手动下载

1. 访问 fnm Releases 页面
2. 下载适合你架构的压缩包：

# x86_64
wget https://github.com/Schniz/fnm/releases/latest/download/fnm-linux.zip

# ARM64
wget https://github.com/Schniz/fnm/releases/latest/download/fnm-arm64.zip

3. 解压并安装：

unzip fnm-linux.zip -d ~/.local/bin
chmod +x ~/.local/bin/fnm

各发行版安装指南

Ubuntu / Debian

# 方法 1: 使用 curl 脚本
curl -fsSL https://fnm.vercel.app/install | bash

# 方法 2: 手动安装
sudo apt update
sudo apt install -y unzip
wget https://github.com/Schniz/fnm/releases/latest/download/fnm-linux.zip
sudo unzip fnm-linux.zip -d /usr/local/bin
sudo chmod +x /usr/local/bin/fnm

CentOS / RHEL / Fedora

# 安装依赖
sudo dnf install -y unzip  # Fedora
# 或
sudo yum install -y unzip  # CentOS/RHEL

# 使用 curl 脚本
curl -fsSL https://fnm.vercel.app/install | bash

# 或手动安装
wget https://github.com/Schniz/fnm/releases/latest/download/fnm-linux.zip
sudo unzip fnm-linux.zip -d /usr/local/bin
sudo chmod +x /usr/local/bin/fnm

Arch Linux

# 使用 AUR helper
yay -S fnm-bin

# 或从 AUR 构建
git clone https://aur.archlinux.org/fnm-bin.git
cd fnm-bin
makepkg -si

Alpine Linux

# 安装依赖
apk add bash curl unzip

# 使用 curl 脚本
curl -fsSL https://fnm.vercel.app/install | bash

# 或手动安装
wget https://github.com/Schniz/fnm/releases/latest/download/fnm-linux.zip
unzip fnm-linux.zip -d ~/.local/bin
chmod +x ~/.local/bin/fnm

配置 Shell

Bash

编辑 ~/.bashrc：

echo 'eval "$(fnm env --use-on-cd)"' >> ~/.bashrc
source ~/.bashrc

Zsh

编辑 ~/.zshrc：

echo 'eval "$(fnm env --use-on-cd)"' >> ~/.zshrc
source ~/.zshrc

Fish

编辑 ~/.config/fish/config.fish：

echo 'fnm env --use-on-c | source' >> ~/.config/fish/config.fish
source ~/.config/fish/config.fish

Shell 补全

Bash 补全

# 安装 bash-completion（如果未安装）
sudo apt install bash-completion  # Debian/Ubuntu
sudo dnf install bash-completion  # Fedora

# 添加补全脚本
fnm completions --shell bash >> ~/.bashrc
source ~/.bashrc

Zsh 补全

# 创建补全目录
mkdir -p ~/.zsh/completions

# 生成补全脚本
fnm completions --shell zsh > ~/.zsh/completions/_fnm

# 在 ~/.zshrc 中添加
fpath=(~/.zsh/completions $fpath)
autoload -U compinit && compinit

Fish 补全

fnm completions --shell fish > ~/.config/fish/completions/fnm.fish

使用国内镜像

在中国大陆，建议配置镜像加速下载：

# 在 Shell 配置文件中添加
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node

# 或者在 eval 时指定
eval "$(fnm env --use-on-cd --node-dist-mirror=https://npmmirror.com/mirrors/node)"

常用镜像：

镜像源	地址
npmmirror	https://npmmirror.com/mirrors/node
清华大学	https://mirrors.tuna.tsinghua.edu.cn/nodejs-release
华为云	https://mirrors.huaweicloud.com/nodejs

验证安装

# 检查 fnm 版本
fnm --version

# 安装 Node.js
fnm install --lts

# 验证 Node.js
node --version
npm --version

常见问题

命令找不到

# 检查 fnm 是否在 PATH 中
which fnm

# 手动添加到 PATH
export PATH="$HOME/.fnm:$PATH"

# 永久添加到 PATH
echo 'export PATH="$HOME/.fnm:$PATH"' >> ~/.bashrc

权限问题

# 确保 fnm 有执行权限
chmod +x ~/.fnm/fnm
# 或
chmod +x /usr/local/bin/fnm

下载失败

# 使用镜像
export FNM_NODE_DIST_MIRROR=https://npmmirror.com/mirrors/node
fnm install --lts

下一步

安装完成后，你可以：

• 安装 Node.js - 使用 fnm 安装 Node.js
• 命令参考 - 了解所有可用命令
• 版本管理 - 学习版本管理

相关链接

• 安装 fnm - 通用安装指南
• Windows 安装 - Windows 安装指南
• macOS 安装 - macOS 安装指南
• Ubuntu 卸载 - Ubuntu 卸载指南