macOS 15 使用 fnm 管理 Node.js

安装 fnm

使用 Homebrew 安装 fnm:

brew install fnm

设置 fnm 环境变量:

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

刷新 Zsh 配置文件:

source ~/.zshrc

查看安装的 fnm 版本:

fnm -V
fnm 1.38.1

安装 Node.js

根据需要安装 Node.js 的 LTS 版本(这里是 node@20 ):

fnm install 20

安装完成即可,不需要手动设置环境变量。

如果安装过程出错:

error: Can't download the requested binary: Can't extract the file: failed to unpack...

尝试使用 Debug 模式安装,以便于查找出错的原因:

RUST_LOG=debug fnm install 20

设定当前安装的版本为全局默认版本:

fnm default 20

查看安装的 Node.js 版本:

node -v
v20.19.2

使用 fnm 管理 Node.js

查看 Node.js

查看所有支持的 Node.js 版本:

fnm list-remote

查看本地已安装的 Node.js 版本:

fnm list

查看当前使用的 Node.js 版本:

fnm current

安装 Node.js

安装最新的 LTS 版本:

fnm install --lts

安装指定版本的 Node.js:

fnm install <version>

<version> 可以是完整的语义化版本号,也可以是 major 版本号(会安装这个 major 版本的最新版本)。

设定 Node.js 版本

设定 Node.js 版本时版本号 <version> 可以是完整的语义化版本号,也可以是 major 版本号(使用本地已安装的这个 major 版本的最新版本)。

设定全局默认的 Node.js 版本:

fnm default <version>

设定当前 shell 环境下使用的 Node.js 版本:

fnm use <version>

在项目中指定 Node.js 版本,需要在项目根目录下添加 .node-version.nvmrc 文件,写入要使用的版本:

<version>

卸载 Node.js

卸载制定版本的 Node.js:

fnm uninstall <version>

卸载 fnm

使用 Homebrew 卸载 fnm:

brew uninstall fnm

删除 fnm 保存文件的目录:

rm -rf ~/.local/share/fnm/

编辑 Zsh 配置文件:

vim ~/.zshrc

删除 Zsh 配置文件中 fnm 的环境变量配置:

eval "$(fnm env --use-on-cd --shell zsh)"

刷新 Zsh 配置:

source ~/.zshrc

参考文献