解决国内服务器 npm install 卡住的问题

在使用国内云服务器时,经常会遇到 npm install 命令执行卡住的情况。本文将分享一个典型案例以及常见的解决方案。

问题描述

在执行以下命令时:

bash 复制代码
mkdir test-npm
cd test-npm
npm init -y
npm install lodash --verbose

安装过程会卡在这个状态:

复制代码
(⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂⠂) ⠙ idealTree:test-npm: sill idealTree buildDeps

常见原因及解决方案

  1. 网络连接问题
    这是最常见的原因之一。可以通过以下步骤诊断和解决:
bash 复制代码
# 测试网络连接
ping registry.npmjs.org

# 切换为国内镜像源
npm config set registry https://mirrors.huaweicloud.com/repository/npm/
  1. npm 缓存问题
    缓存可能会导致安装卡住,可以尝试清除缓存:
bash 复制代码
npm cache clean --force
  1. package-lock.json 冲突
    有时候 package-lock.json 文件可能会导致冲突:
bash 复制代码
# 删除相关文件后重新安装
rm -rf package-lock.json node_modules
npm install
  1. Node.js 版本兼容性问题
    检查 Node.js 版本是否合适:
bash 复制代码
node -v
  1. 磁盘空间不足
    确保有足够的磁盘空间:
bash 复制代码
df -h

解决方案:切换国内镜像源

在我的案例中,问题的根源是网络连接问题。通过切换到国内镜像源成功解决了这个问题。以下是推荐的国内镜像源:

华为云镜像源(推荐)

bash 复制代码
npm config set registry https://mirrors.huaweicloud.com/repository/npm/

阿里云镜像源

需要特别注意,阿里云的旧版本源已经停止服务,请使用新版本源:

bash 复制代码
# ⚠️ 旧版本源(已于 2022.06.30 停止服务)
# npm config set registry https://registry.npm.taobao.org/

# ✅ 新版本源
npm config set registry https://registry.npmmirror.com

总结

当遇到 npm install 卡住的情况时,建议首先尝试切换到国内镜像源,特别是华为云镜像源,这通常能解决大部分问题。如果问题仍然存在,可以按照上述步骤逐一排查其他可能的原因。

记住:使用国内镜像源时,一定要确保使用的是最新的地址,特别是阿里云镜像源,避免使用已经停止服务的旧地址。

相关推荐
陈随易1 分钟前
PM2 突然更新,从v5.4.2跳到v6.0.5,正式支持Node.js最强竞品Bun
前端·后端·程序员
还是鼠鼠18 分钟前
Node.js 模块的分类 & require 的使用详细介绍
前端·javascript·vscode·node.js·web
醒雷工程师26 分钟前
Ant Design Vue UI框架快速打造后台管理管理案例
前端·vue.js·ui
我不是迈巴赫29 分钟前
自定义tiptap插件
前端·javascript
我不是迈巴赫29 分钟前
iptap搭建仿google-docs工具栏
前端·javascript
我不是迈巴赫36 分钟前
使用tiptap快速搭建markdown/富文本编辑器
前端·javascript
竺梓君1 小时前
同学,你真的了解spa吗
前端·javascript·vue.js
wordbaby1 小时前
通过共享 Promise 解决前端重复请求
前端·promise
wordbaby1 小时前
前端请求处理增加版
前端·javascript
慢知行1 小时前
优化前端图标:SVG Sprite与Vite插件的探索之旅
前端·vue.js·vite