1. 解决NVM安装Node.js时卡在克隆仓库的问题
最近在帮团队配置前端开发环境时,遇到了一个典型问题:使用NVM安装Node.js时卡在了Cloning into '/home/user/.nvm'...这一步。作为经历过多次类似场景的老手,我整理了一套完整的解决方案和深度分析。
1.1 问题现象还原
按照官方文档执行以下命令时:
bash复制curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
出现了两种异常情况:
- 初始下载速度为0(完全无进度)
- 开启网络加速工具后能下载但卡在克隆阶段
- 最终关闭网络加速工具才完成安装
重要提示:网络环境对NVM安装影响极大,但解决方案不止一种
1.2 底层原理分析
这个问题本质上是Git仓库克隆过程中的网络问题。NVM的安装脚本会做以下操作:
- 下载install.sh脚本
- 脚本自动克隆nvm仓库到~/.nvm目录
- 配置环境变量
卡住的原因通常有:
- GitHub的raw.githubusercontent.com域名解析问题
- Git协议(默认使用SSH)的端口限制
- 本地Git配置不完整
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 五种解决方案实测对比
2.1 方法一:改用HTTPS协议(推荐)
在安装前执行:
bash复制export NVM_SOURCE=https://github.com/nvm-sh/nvm.git
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
原理:强制使用HTTPS而非SSH协议克隆,绕过可能的端口限制
2.2 方法二:手动指定Git镜像源
bash复制git config --global url."https://hub.fastgit.org".insteadOf https://github.com
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash
`
