在接手同事开发的前端项目时,经常会遇到 npm
包版本低或者安装失败,还有其它的系统软件缺少问题。
这时候不要着急,包的版本低问题不大,项目还是可以运行的,安装失败有可能是网络延迟高,换个时间试试看,其它的系统软件缺少等问题可以按照提示尝试解决,不过最重要的是要确认 Node
的版本。
Node
版本管理工具
使用 Node
版本管理工具,切换项目使用的版本,可以解决大部分的疑难杂症。这里要介绍的是 nvm
的版本管理工具,全名是 node version manager
。
在安装这个软件工具之前,咱们要先卸载之前安装的 Node
,安装好版本管理之后,就用这个工具安装 Node
的各种版本,以及切换版本。
卸载 Node
检查是否安装了 Node
,命令行里输入 node -v
npm -v
就可以看到结果了。
针对 window
系统,我要多说一句,win+R
输入 cmd
调出命令行窗口;或者在文件夹的路径里输入 cmd
,可以在当前目录下执行命令哦。
要是安装了 Node
或者 Yarn
都要卸载,这里要介绍一下 Yarn
,它是一个包管理工具,比较简洁优雅,安装的包版本固定,可以并行安装,可以读取缓存离线安装,不过它不会和 Node
一起安装的。在 控制面板
的卸载程序里找到 nodejs
然后右键卸载就完成了。
接下来要删除残留文件,
C:\User\用户名
这里要删除 .npmrc
;
C:\Program Files (x86)\Nodejs
这里要删除文件夹 ;
C:\Program Files\Nodejs
这里要删除文件夹 ;
C:\Users\用户名\AppData\Roaming\
这里要删除 npm
npm-cache
;
最后删除环境变量,
在 我的电脑
的 属性-高级-环境变量-用户变量
的 path
字段和 系统变量
的 node_path
字段里删除整个字段。再次检查是否卸载 node -v
npm -v
,需要重启电脑。
安装 nvm
版本管理工具
地址 https://github.com/coreybutler/nvm-windows/releases/tag/1.1.10
进入仓库主页,下载 nvm-setup.exe
安装在 window
系统里。
以管理员身份执行 cmd
,执行以下命令,
nvm list
查看 node
版本;
nvm install 12.22.7
安装指定版本 node
和对应的 npm
;
nvm use 12.22.7
切换 node
版本;
nvm install latest
最新版本;
nvm use lts
长期支持版本 bug
更少。
切换版本后,问题一下子少了很多。但是,可能还有一点问题,比如 Npm
包的问题。
报错 9009
以及清空 npm
可以使用以下命令来清空,
npm cache clean --force
rm -rf node_modules package-lock.json
npm install
npm run dev
清空安装的包,重新安装包,是个比较彻底,但是缓慢的过程。有时候只是其中一个包有问题而已,那就具体问题具体分析,一般是版本低的问题,或者是网络延迟高的问题。
国内镜像
使用国内镜像的包,更容易安装成功。要是失败可能是网络延迟高的问题,换个时间再试试看吧。命令如下,
npm install -g cnpm --registry=https://registry.npm.taobao.org
npm config set sass_binary_site=https://npm.taobao.org/mirrors/node-sass
npm config set registry https://registry.npm.taobao.org
npm config get registry
https://registry.npmjs.org/