NVM の 安装指南

PlotoZzz
166 阅读3分钟

《前端の版本事故报告》

案发现场一：
当你哼着《向云端》快乐git clone时
终端突然蹦出血红大字——
Error: Node.js 14.18.1 is required
而你电脑里住着个穿V20超短裙的node小姐姐
此刻你终于明白：
时间旅行最大的BUG不是蝴蝶效应
而是node版本不兼容！

案发现场二：
刚用Promise.allSettled()写完风骚代码
突然钉钉跳出祖传Vue2项目の求救信号
当你颤抖着打开尘封的package.json：
"webpack": "^3.8.1"正在和"vue-template-compiler"
用二进制摩斯密码互骂
而npm install正在把node_modules
编译成当代前端十大未解之谜

案发现场三：
正当你在React18用useActionState纵享丝滑
领导突然发来React15.xの圣旨：
"给componentWillReceiveProps王朝
修个props传参殉葬坑"
你看着比恐龙化石还老的mixins文件夹
终于领悟到：
前端工程师的尽头不是架构师
是带着TypeScript去考古的盗墓笔记！

滚粗！滚粗！ node 版本问题全部滚粗！

接下来将带你领略 NVM , 从此走上不归路。

Step 1：弑神仪式 - 旧Node的彻底毁灭
❶ 打开【控制面板】->【卸载程序】

  • 搜索Node.js，右键选择【卸载】
  • 重点击杀对象：任何带Node.js/npm字样的程序

❷ 开启"显示隐藏文件"（文件资源管理器->查看->勾选隐藏的项目）

  • 执行三光政策：

    # 核弹级清理清单
C:\Program Files\nodejs\             # node本体刑场
C:\Users\你的用户名\AppData\Roaming\npm\    # npm幽灵老巢
C:\Users\你的用户名\AppData\Roaming\npm-cache\  # 缓存僵尸
C:\Users\你的用户名\AppData\Local\npm-cache\    # 缓存分身

❸ 注册表补刀（Win+R输入regedit）：

  • 删除 HKEY_LOCAL_MACHINE\SOFTWARE\Node.js
  • 删除 HKEY_CURRENT_USER\Software\Node.js
    （操作前建议先导出备份 避免手滑送走系统）

Step 2：请神仪式 - nvm-windows的降临
❶ 下载神器：

❷ 安装玄学：

  • 安装路径示例：D:\nvm （路径不要有中文/空格！）
  • nodejs路径示例：C:\Program Files\nodejs （保持默认即可）
  • 勾选【自动配置系统环境变量】（重要！）

❸ 环境变量验尸报告：
右键【此电脑】->【属性】->【高级系统设置】->【环境变量】
确保存在以下变量：

NVM_HOME = D:\nvm  
NVM_SYMLINK = C:\Program Files\nodejs  
PATH += %NVM_HOME%;%NVM_SYMLINK%

Step 3：镜像の黑魔法
打开D:\nvm\settings.txt，注入中国速度：

root: D:\nvm  
path: C:\Program Files\nodejs  
node_mirror: https://npmmirror.com/mirrors/node/  
npm_mirror: https://npmmirror.com/mirrors/npm/  
# 2024年实测有效的镜像源

Step 4：神启时刻 - 基础指令大全
（以管理员身份打开CMD/PowerShell）

# 版本操控の奥义
nvm list available  # 查看可安装版本（建议安装LTS版）
nvm install 18.20.0 --arch=64  # 安装指定版本（64位系统必须加--arch）
nvm use 18.20.0     # 切换版本（需要管理员权限！）
nvm ls              # 查看已安装全家桶

# 高阶骚操作
nvm on              # 开启nvmの神力
nvm off             # 封印nvm（慎用！）
nvm proxy "http://127.0.0.1:7890"  # 魔法上网专用
nvm root D:\new_nvm # 修改nvm本体位置

Step 5：渡劫指南 - 常见天雷滚滚
⚡ 报错exit status 1:乱码：

  • 用where node检查是否还有漏网之鱼
  • 删除残留的node.exe/npm.cmd

⚡ 切换版本无效：

  • 关闭所有终端后用管理员身份重新打开
  • 执行nvm uninstall 版本号再重装

⚡ 安装卡在Downloading npm...：

  • 检查镜像源是否带/结尾（必须要有！）
  • 临时关闭杀毒软件/windows defender

隐藏技巧：
在项目根目录创建.nvmrc文件：

18.20.0

执行nvm use自动切换版本（需要先安装对应版本）

（突然弹出《黑客帝国》风格弹窗）
⚠️ 终极警告
每次切换版本后：

  • 全局安装的包会留在旧版本

  • 需要在新版本中重新npm install -g 包名

  • 建议用nvm reinstall-packages迁移全局包

avatar
文章
阅读
粉丝