fnm-node版本管理

什么是 Node 版本管理

Node.js 是一个开源、跨平台的 JavaScript 运行时环境，使得 JavaScript 能够运行在服务端，在现代前端和全栈开发中具有重要地位。

通常，我们会直接访问 Node.js 官网下载并安装 Node.js。但这种方式存在两个常见问题：

版本更新频繁：Node.js 的版本迭代较快，手动检查更新和重新安装新版本非常耗时。
无法并存多个版本：一台计算机上通常只能安装一个版本的 Node.js。这在需要不同版本支持的项目中可能会带来困扰，例如，一个项目依赖 Node.js v16，而另一个项目需要 Node.js v18。

为了简化版本管理并实现不同版本间的快速切换，我们可以使用 Node 版本管理工具来解决这些问题。

fnm 是什么

🚀 fnm（Fast Node Manager）是一个快速、简洁的 Node.js 版本管理器，用 Rust 构建，能够帮助我们轻松管理和切换 Node.js 版本。

fnm 安装

在 Windows 上，可以通过以下命令安装 fnm：

winget install Schniz.fnm

fnm 配置

在安装后，fnm 需要配置环境变量，以便在不同路径下自动加载所需的 Node.js 版本。请按以下步骤配置：

配置 fnm 环境变量

在 PowerShell 中，fnm 的环境变量需要添加到 PowerShell 配置文件中，以便每次启动时自动加载。

步骤 1：打开 PowerShell 配置文件

使用以下命令编辑 PowerShell 配置文件：
```
notepad $PROFILE
```
如果文件不存在，系统会提示创建新文件。

步骤 2：添加 fnm 配置命令

在配置文件中添加以下内容：
```
fnm env | Out-String | Invoke-Expression
```
这样，每次启动 PowerShell 时，fnm 都会自动加载所需的环境变量。

步骤 3：保存并重启 PowerShell

保存配置文件并重启 PowerShell，以确保配置生效。
验证配置

在 PowerShell 重新启动后，运行以下命令验证 fnm 是否正确配置：
```
fnm use 16.20.2
```
这将切换到指定的 Node.js 版本，如果没有报错说明配置成功。
检查配置文件路径

如果需要确认配置文件的具体路径，可以运行以下命令：
```
echo $PROFILE
```
该路径通常位于用户目录下的 Documents\PowerShell\Microsoft.PowerShell_profile.ps1。
设置 PowerShell 执行策略

如果 PowerShell 阻止脚本运行，可能是执行策略限制了脚本的执行。可以通过以下步骤解决：
- 检查当前执行策略：
```
Get-ExecutionPolicy
```
  如果结果是 Restricted，表示脚本执行被禁用。
- 临时允许脚本执行：
  
  如果只需在当前会话允许脚本运行：
```
Set-ExecutionPolicy Bypass -Scope Process
```
- 永久更改执行策略：
  
  如果希望永久启用脚本执行，运行以下命令：
```
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
```
  RemoteSigned 策略允许本地脚本直接运行，而外部下载的脚本需经过签名认证。
- 重新加载配置文件：
  
  修改执行策略后，重新加载 PowerShell 配置文件：
```
. $PROFILE
```
设置通过注册表 AutoRun 让每次 cmd.exe 启动都自动执行 fnm 初始化脚本。
- 在你的用户目录（通常是 C:\Users\你的用户名）新建一个文件，命名为 fnm_init.cmd（可以用记事本创建）。
- 把下面这段内容完整复制进去并保存：
```
@echo off
:: 防止无限循环
if not defined FNM_AUTORUN_GUARD (
    set "FNM_AUTORUN_GUARD=AutorunGuard"
    FOR /f "tokens=*" %%z IN ('fnm env --use-on-cd') DO CALL %%z
)
```
- 打开 PowerShell（普通用户权限就行，不用管理员）按 Win + S 搜索 “PowerShell”，打开即可。
- 粘贴下面这行命令并回车（会自动设置注册表）：
```
Set-ItemProperty -Path "HKCU:\Software\Microsoft\Command Processor" -Name "AutoRun" -Value "%USERPROFILE%\fnm_init.cmd"
```
  - 如果出现
    Set-ItemProperty : 找不到路径“HKCU:\Software\Microsoft\Command Processor”，因为该路径不存在。所在位置行:1 字符: 1
    HKCU:\Software\Microsoft\Command Processor 这个注册表键默认不存在（这是 Win11 的常见情况），所以直接 Set-ItemProperty 会报路径找不到。
    
    解决方法（2 行命令，30 秒搞定）：
    
    在你当前的 PowerShell 窗口里，依次粘贴下面两行命令并回车：
    # 1. 先创建缺失的注册表键（-Force 会自动创建） New-Item -Path "HKCU:\Software\Microsoft\Command Processor" -Force # 2. 设置 AutoRun，让每次 cmd 启动都自动执行你的 fnm_init.cmd Set-ItemProperty -Path "HKCU:\Software\Microsoft\Command Processor" -Name "AutoRun" -Value "$env:USERPROFILE\fnm_init.cmd"
    执行完后应该看到类似下面输出（没有报错就成功）：
    Hive: HKEY_CURRENT_USER\Software\Microsoft Name Property ---- -------- Command Processor
- 完全关闭所有 cmd、PowerShell、VS Code、Windows Terminal 等窗口。
- 重新打开测试：
  - 直接 Win + R 输入 cmd 回车 → node -v 应该直接显示 v22.11.0
  - 打开 VS Code → 按 Ctrl + 打开终端（如果默认不是 cmd，就点右下角选 “Command Prompt”）→node -v` 也应该正常
  - 进入任意项目文件夹，如果有 .node-version 文件，会自动切换版本
如果以后想撤销（恢复原状）

在 PowerShell 执行：
```
Remove-ItemProperty -Path "HKCU:\Software\Microsoft\Command Processor" -Name "AutoRun"
```

常用 fnm 命令

下载并使用指定版本：
```
fnm use --install-if-missing 16
```
卸载指定版本：
```
fnm uninstall 16.12.0
```
查看本地安装的 Node.js 版本：
```
fnm list
```
设置全局默认版本：
```
fnm default 16.12.0
```
在当前 Shell 中使用指定版本：
```
fnm use 16.12.0
```

通过 fnm，我们可以简化 Node.js 版本管理流程，快速切换 Node.js 版本并解决项目依赖不同版本带来的兼容性问题。

什么是 Node 版本管理​

fnm 是什么​

fnm 安装​

fnm 配置​

步骤 1：打开 PowerShell 配置文件​

步骤 2：添加 fnm 配置命令​

步骤 3：保存并重启 PowerShell​

如果以后想撤销（恢复原状）​

常用 fnm 命令​

什么是 Node 版本管理

fnm 是什么

fnm 安装

fnm 配置

步骤 1：打开 PowerShell 配置文件

步骤 2：添加 fnm 配置命令

步骤 3：保存并重启 PowerShell

如果以后想撤销（恢复原状）

常用 fnm 命令