前置：

我本地是windows的nodejs是14的版本，如何兼容nodejs最新版呢？因为我要下载iflow cli，流心4要求Node.js 22+

流心官网：https://platform.iflow.cn/cli/quickstart

---

要在 Windows 上同时保留 Node.js 14 并兼容最新版（安装 iFlow CLI 需要 Node.js 22+），最佳方案是使用 nvm-windows（Node 版本管理器），实现多版本共存、一键切换。

---

一、准备：卸载原有独立 Node（必做）

先卸载你当前的 Node.js 14，避免与 nvm 冲突：

1. 控制面板 → 程序 → 卸载 Node.js
2. 删除残留文件夹（如有）：
   • C:\Program Files\nodejs
   • C:\Users\你的用户名\AppData\Roaming\npm
   • C:\Users\你的用户名\AppData\Roaming\npm-cache
3. 检查系统环境变量 Path，删除所有 Node/npm 相关路径

---

二、安装 nvm-windows

1. 下载：去 GitHub 下载最新版 nvm-setup.exe    nvm-setup下载地址   下载后，解压文件

2. 安装：

   • 双击.exe运行，同意协议
   • NVM 安装路径：建议 D:\nvm（无中文、无空格）
   • Node 符号链接路径：建议 D:\nodejs（软链接，自动加入 Path）
   • 一路 Next → Install → Finish

下面两个都要放D盘哦，能避免 C 盘空间爆满，也能解决 Windows 上常见的权限问题（比如写入文件报错）。

        3.验证安装（新开管理员终端）：

nvm version

输出版本号（如 1.1.12）即成功。

---

三、安装 Node.js 14 + 22（双版本）

1. 配置国内镜像（加速下载）

nvm node_mirror https://npmmirror.com/mirrors/node/
nvm npm_mirror https://npmmirror.com/mirrors/npm/

2. 安装你需要的版本

# 安装 Node 14（保留旧环境）
nvm install 14

# 安装 Node 22（iFlow CLI 必需）
nvm install 22

这步没问题，这块引用就不用看了，直接看下面3. 查看已装版本

如果出现和我一样的问题：

这个报错是镜像源访问超时 / 失效导致的，npmmirror.com 这个源现在连不上了，我们换个稳定的国内镜像就能解决：

在管理员 CMD里，依次执行这两条命令，把镜像换成淘宝 / 阿里的稳定源：

# 配置 Node 下载镜像（淘宝源，稳定可用）
nvm node_mirror https://npmmirror.com/mirrors/node/
# 配置 npm 下载镜像
nvm npm_mirror https://npmmirror.com/mirrors/npm/

如果上面的还是不行，直接用清华源：

nvm node_mirror https://mirrors.tuna.tsinghua.edu.cn/nodejs-release/

第二步：重新安装 Node 22

配置完镜像后，直接执行安装命令：

nvm install 22

3. 查看已装版本

nvm list

  输出示例：

* 22.11.0 (Currently using 64-bit)
  14.21.3

---

四、切换版本（使用 iFlow 时切到 22）

1. 临时切换（当前终端）

# 用 Node 22（装 iFlow）
nvm use 22

# 切回 Node 14（旧项目）
nvm use 14

⚠️ 必须用管理员终端执行 nvm use，否则会报错 exit status 1。

2. 设默认版本（开机自动用）

# 默认用 22
nvm default 22

# 默认用 14
nvm default 14

---

五、安装 iFlow CLI（Node 22 下）

1. 确认当前版本：

   node -v  # 必须 v22.x.x
   npm -v   # 对应 10+
   

2. 安装 iFlow CLI：

   npm install -g @iflow-ai/iflow-cli@latest
   

3. 验证：

   iflow --version

---

六、日常使用总结

• 旧项目（Node 14）：

  nvm use 14
  

• iFlow CLI（Node 22）：

  nvm use 22
  iflow
  

这样既保留了原有 14 环境，又能满足流心 4 对 Node 22+ 的要求，完全兼容、互不干扰。

---

七、使用效果

在终端输入命令

iflow

如上图启动成功~就可以使用辣~具体如何使用看文字开头流心官网的操作手册。