前端依赖安装指南

前端依赖安装指南

一、NVM管理工具安装

1.在 Windows 上安装

1. 下载 NVM for Windows 的安装程序：(最新版本可以在 nvm-windows Releases 页面 找到)
2. 运行下载的安装程序并按步骤操作。

2.配置 NVM

exe安装自动配置环境变量

3. 验证 NVM 安装

验证 NVM 是否成功安装，可以使用以下命令：

nvm --version  

如果显示版本号，则表示安装成功。

4. 使用 NVM 安装 Node.js

nvm install <version>  

5.切换 Node.js 版本

nvm use 14  

二、问题排查

1. 清理缓存

如果在安装依赖时遇到问题，首先清理 npm 缓存：

npm cache clean --force  
npm install  

2. 删除现有依赖

删除 node_modules 和 package-lock.json 文件，清空依赖环境：

rm -rf node_modules  
rm package-lock.json  
npm install  

3. 检查 package.json

确保 package.json 中的依赖项列出完整且无误。必要时手动添加缺失的依赖。

4. 处理依赖冲突

遇到依赖冲突时，尝试使用以下命令：

npm install --legacy-peer-deps  

5. 更换 npm 镜像源

为了解决网络问题，可以切换到淘宝的 npm 镜像源：

npm config set registry https://registry.npm.taobao.org  
npm install  

6. 检查版本

确认使用的 Node.js 和 npm 版本是最新的：

node -v  
npm -v  

更新 npm：

npm install -g npm  

7. 尝试其他包管理工具

如仍有问题，考虑使用 pnpm 或 yarn 安装依赖：

# 使用 pnpm  
pnpm install  # 使用 yarn  
yarn install  

8. 检查错误日志

如果问题依旧，查看详细的错误日志：

npm install --verbose