fnm

<h1 align="center"> 快速节点管理器 (<code>fnm</code>) <img alt="下载量" src="https://yellow-cdn.veclightyear.com/2b54e442/aa2131e9-2ec5-4325-9919-b45cf618a38c.svg?style=flat" /> <a href="https://github.com/Schniz/fnm/actions"><img src="https://img.shields.io/github/actions/workflow/status/Schniz/fnm/rust.yml?branch=master&label=workflow" alt="GitHub Actions 工作流状态" /></a> </h1>

🚀 快速简单的 Node.js 版本管理器，使用 Rust 构建

<div align="center"> <img src="https://yellow-cdn.veclightyear.com/2b54e442/45caa002-f2ba-484d-9d11-6506f83af3d9.svg" alt="速度飞快！"> </div>

特性

🌎 跨平台支持（macOS、Windows、Linux）

✨ 单文件、易安装、即时启动

🚀 注重速度设计

📂 支持 .node-version 和 .nvmrc 文件

安装

使用脚本（macOS/Linux）

对于 bash、zsh 和 fish shell，有一个自动安装脚本。

首先确保你的操作系统已安装 curl 和 unzip。然后执行：

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

升级

在 macOS 上，只需执行 brew upgrade fnm。

在其他操作系统上，升级 fnm 几乎与安装相同。为防止在 shell 配置文件中重复，在安装命令中添加 --skip-shell。

参数

--install-dir

设置 fnm 安装的自定义目录。默认为 $XDG_DATA_HOME/fnm（如果未定义 $XDG_DATA_HOME，则在 Linux 上默认为 $HOME/.local/share/fnm，在 MacOS 上默认为 $HOME/Library/Application Support/fnm）。

--skip-shell

跳过将特定 shell 加载器添加到 shell 配置文件，基于当前用户 shell，定义在 $SHELL 中。例如，Bash 为 $HOME/.bashrc，Zsh 为 $HOME/.zshrc，Fish 为 $HOME/.config/fish/conf.d/fnm.fish。

--force-install

使用安装脚本的 macOS 安装已被弃用，推荐使用 Homebrew formula，但此选项强制使用脚本安装。

示例：

curl -fsSL https://fnm.vercel.app/install | bash -s -- --install-dir "./.fnm" --skip-shell

手动安装

使用 Homebrew（macOS/Linux）

brew install fnm

然后，为 fnm 设置你的 shell

使用 Winget（Windows）

winget install Schniz.fnm

使用 Scoop（Windows）

scoop install fnm

然后，为 fnm 设置你的 shell

使用 Chocolatey（Windows）

choco install fnm

然后，为 fnm 设置你的 shell

使用 Cargo（Linux/macOS/Windows）

cargo install fnm

然后，为 fnm 设置你的 shell

使用发布二进制文件（Linux/macOS/Windows）

• 下载适用于你系统的最新发布二进制文件
• 使其在 PATH 环境变量中全局可用
• 为 fnm 设置你的 shell

卸载

要卸载 fnm（😢），只需删除主目录中的 .fnm 文件夹。你还应该编辑 shell 配置以删除对 fnm 的任何引用（即阅读 Shell 设置，然后执行相反的操作）。

自动补全

fnm 随二进制文件一起提供其自动补全：

fnm completions --shell <SHELL>

其中 <SHELL> 可以是以下支持的 shell 之一：

• bash
• zsh
• fish
• power-shell

请按照你的 shell 说明安装它们。

Shell 设置

在开始使用 fnm 之前，需要设置环境变量。 这是通过评估 fnm env 的输出来完成的。

[!注意] 查看配置部分以启用强烈推荐的功能，如自动版本切换。

向你的项目添加 .node-version 文件非常简单：

$ node --version
v14.18.3
$ node --version > .node-version

查看以下适用于你所使用 shell 的指南：

Bash

将以下内容添加到你的 .bashrc 配置文件中：

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

Zsh

将以下内容添加到你的 .zshrc 配置文件中：

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

Fish shell

创建 ~/.config/fish/conf.d/fnm.fish 并添加以下行：

fnm env --use-on-cd --shell fish | source

PowerShell

将以下内容添加到你的配置文件末尾：

fnm env --use-on-cd --shell power-shell | Out-String | Invoke-Expression

• 对于 macOS/Linux，配置文件位于 ~/.config/powershell/Microsoft.PowerShell_profile.ps1
• 在 Windows 上，要编辑你的配置文件，可以在 PowerShell 中运行以下命令

  notepad $profile

Windows 命令提示符（CMD）

fnm 也支持 CMD，但覆盖不完全。你可以设置一个启动脚本并附加以下行：

@echo off
:: for /F 将启动一个新的 cmd 实例，因此我们创建一个守卫以防止无限循环
if not defined FNM_AUTORUN_GUARD (
    set "FNM_AUTORUN_GUARD=AutorunGuard"
    FOR /f "tokens=*" %%z IN ('fnm env --use-on-cd') DO CALL %%z
)

与 Cmder 一起使用

使用方法与普通 WinCMD 安装非常相似，只是需要进行一些调整以允许从 cmder 启动脚本调用。此示例假设 CMDER_ROOT 环境变量已设置为你的 Cmder 安装的根目录。 然后你可以这样做：

• 创建一个 .cmd 文件来调用它

:: %CMDER_ROOT%\bin\fnm_init.cmd
@echo off
FOR /f "tokens=*" %%z IN ('fnm env --use-on-cd') DO CALL %%z

• 将其添加到启动脚本

:: %CMDER_ROOT%\config\user_profile.cmd
call "%CMDER_ROOT%\bin\fnm_init.cmd"

你也可以将 %CMDER_ROOT% 替换为任何其他方便的路径。

配置

查看可用的配置选项以获取详细的配置文档

用法

查看可用的命令以获取详细的使用文档

贡献

欢迎提交 PR :tada:

开发：

# 安装 Rust
git clone https://github.com/Schniz/fnm.git
cd fnm/
cargo build

运行二进制文件：

cargo run -- --help # 行为类似于 `fnm --help`

运行测试：

cargo test