
fnm 安装教程5 分钟装好 Node.js 多版本管理工具【免费下载链接】fnm Fast and simple Node.js version manager, built in Rust项目地址: https://gitcode.com/gh_mirrors/fn/fnmNode 16、18、20 在同一台机器上打架切版本全靠手动改 PATHfnm 就是来终结这件事的 Node.js 版本管理器。这篇 fnm 安装教程带你 5 分钟完成安装与配置从此 cd 进项目目录就自动切版本。30 秒快速开始如果你赶时间按这三步走就行 ⚡️macOS / Linux 适用Windows 用户装完直接跳到验证一条命令安装——官方脚本会自动下载单文件二进制并帮你写好 shell 配置curl -fsSL https://fnm.vercel.app/install | bash跑完没有报错、终端提示已写入 shell 配置就说明装好了。立即加载环境变量让当前窗口马上能用 fnm不用重开终端eval $(fnm env --use-on-cd --shell bash)执行完无输出即为成功PATH 里已经加入了 fnm 管理的 Node 目录。装一个 LTS 版本并切过去顺便验证一切正常fnm install --lts fnm use lts node -v看到v22.x.x之类的版本号主流程就走完了。以上是快路径下面按你的系统详细走一遍。分平台安装详解三个平台的最优安装方式各不相同对号入座即可。macOS 用 Homebrew 安装 fnm推荐macOS 上 Homebrew 是官方推荐的脚本替代方案——以后升级只需一条brew upgrade fnmbrew install fnm装完它会提示你确认 PATH照提示点一下或直接进入下一步配环境变量即可。替代方式和 Linux 一样用官方脚本需已装curl和unzipcurl -fsSL https://fnm.vercel.app/install | bash效果和 Homebrew 版完全一致区别只是升级要靠脚本重来一遍。macOS 下 fnm 环境变量怎么配macOS 默认 shell 是 zsh把这一行追加到~/.zshrc末尾eval $(fnm env --use-on-cd --shell zsh)然后执行source ~/.zshrc让配置立即生效如果你用 bash就写进~/.bashrc--shell也改成 bash。最后验证安装是否成功fnm -V # 输出示例fnm 1.37.1看到版本号输出即安装成功。Linux 用官方脚本安装 fnm推荐Linux 首选官方脚本因为它会自动识别你正在用的 shell 并写好加载语句一步到位curl -fsSL https://fnm.vercel.app/install | bash装完终端会提示你重启 shell 或重新加载配置文件。替代方式有 Rust 工具链的话可以cargo install fnm装出来的二进制功能完全一样只是要自己配环境变量。Linux 下 fnm 环境变量怎么配用脚本装的通常已经帮你写好了如果是 cargo 等其他方式装的手动补一行到~/.bashrceval $(fnm env --use-on-cd --shell bash)写入后执行source ~/.bashrc让当前窗口生效。用 Fish 的朋友新建~/.config/fish/conf.d/fnm.fish并写入fnm env --use-on-cd --shell fish | sourceFish 新开标签页就会自动加载无需手动 source。验证一下fnm -V node -v # 输出示例fnm 1.37.1 / v22.14.0还没装 Node 就先 fnm install --ltsnode -v能打出版本号说明环境完全就绪。Windows 用 Scoop 或 winget 安装 fnmWindows 上推荐 Scoop个人机免管理员权限、装完直接进 PATHscoop install fnm装完 Scoop 会自动把 fnm 加进 PATH不需要额外设置。替代方式winget install Schniz.fnm或choco install fnm三选一即可装的是同一个二进制。Windows 下 fnm 环境变量怎么配打开 PowerShell先确认 profile 文件存在if (-not (Test-Path $profile)) { New-Item $profile -Force }文件已存在时这条命令没有任何输出属于正常情况。然后用Invoke-Item $profile打开 profile 文件把下面这行追加进去fnm env --use-on-cd --shell powershell | Out-String | Invoke-Expression保存后重开 PowerShell以后每次启动都会自动加载 fnm 环境。验证fnm -V # 输出示例fnm 1.37.1输出 fnm 版本号即成功。高频命令速查以下命令覆盖日常 90% 场景 先收藏再看。命令作用示例fnm install 版本安装指定版本支持lts或--latestfnm install 20.11.0fnm use 版本切换当前 shell 的 Node 版本fnm use ltsfnm default 版本设置或查看默认版本fnm default 20fnm ls查看本地已安装的版本fnm lsfnm ls-remote列出远端可用版本加--lts只看 LTSfnm ls-remote --ltsfnm current查看当前生效的 Node 版本fnm currentfnm uninstall 版本卸载本地某个版本fnm uninstall 18安装后最常踩的坑这三个问题基本占了求助帖的九成 ⚠️ 别慌都能一两条命令解决。敲 fnm 提示 command not found现象明明装完了一敲 fnm 终端就说不认识这个命令。原因环境变量没加载——要么fnm env那行没写进配置文件要么你用的还是配置前就开着的旧终端。解决先在当前窗口手动加载试试eval $(fnm env --use-on-cd --shell bash)如果加载后能用了说明就是配置文件漏写把这一行补上再重开终端即可。cd 进项目Node 版本却没自动切现象项目根目录明明有.node-versioncd 进去node -v还是老版本。原因fnm env没带--use-on-cd目录切换钩子压根没启用。解决把 env 语句换成带--use-on-cd的版本重新加载eval $(fnm env --use-on-cd --shell zsh)按你的 shell 调整--shell参数重开终端后再 cd 一次试试。fnm install 下载慢或直接失败现象安装 Node 版本时进度条卡住或者直接报网络超时国内网络最常见。原因fnm 默认从 nodejs.org 官方源拉包跨海链路不太稳。解决把FNM_NODE_DIST_MIRROR环境变量指向你常用的 Node 镜像源npmmirror 等国内镜像都可以再执行安装export FNM_NODE_DIST_MIRROR你的 Node 镜像地址 fnm install 20嫌每次 export 麻烦的话把这行 export 写进 shell 配置文件以后装任何版本都走镜像。下一步想看全部参数翻仓库里的docs/commands.md每条命令的 flag 和别名都写得清清楚楚 ✅monorepo 里想让子包也认根目录的.node-version给fnm env加上--version-file-strategyrecursivedocs/configuration.md里有完整示例。进阶玩法fnm alias给版本起别名、fnm exec --usingv20 node --version可以在指定版本下临时跑一条命令不污染当前 shell。现在就 cd 进你的项目目录试试Node 版本会自己跟过去。【免费下载链接】fnm Fast and simple Node.js version manager, built in Rust项目地址: https://gitcode.com/gh_mirrors/fn/fnm创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考