Skip to content
On this page

常见问题

在使用本框架推荐node版本14.18.0以上。使用cnpm或者yarn等脚本工具进行安装依赖。

node -v # 14.18.0
1

安装报错

  • 使用npm i 安装报错

npm i 安装报错

安装出现报错,请查看报错信息,例如以上信息是因为lessless-loader 版本依赖冲突所以导致报错,因此可以更改package.json里面less版本为3.0.0,然后删除node_modules文件夹以及package-lock.json文件,重新安装依赖即可。(其它报错原因,请使用yarn等脚本工具安装)

启动报错

  • 脚本启动报错1

启动报错1启动报错2

以上出错是因为 node 版本问题所致,因为vite分支最低需要14.18.*以上版本才支持!请升级或迁移node合适版本,删除node_modules文件夹以及package-lock.json文件,重新安装依赖即可。怎样升级node版本?

  • 脚本启动报错2

启动报错4

以上出错是因为 node 版本问题所致,当 nodejs 升级到17+版本以后,开始支持 OpenSSL 3.0,而 OpenSSL 3.0 对各种摘要算法做了更严格的限制,可能会导致一些程序运行错误。解决办法如下:

// package.json 文件中 修改启动命令
{
 
  "scripts": {
    "start": "set NODE_OPTIONS=--openssl-legacy-provider && node color && env-cmd --verbose -e development node scripts/start.js",
    // 在命令前加上 set NODE_OPTIONS=--openssl-legacy-provider
  },
}

1
2
3
4
5
6
7
8
9

这里查看讲解文章

  • 脚本启动成功,但是页面打不开?

页面打不开

页面一直圈圈,请检查浏览器控制台网络一项是否加载js,css异常,遇到以上情况请检查网络(全局)代理是否有问题。若无问题,请更换启动端口号如:5147,3001

请求报错

前端请求报错

遇到此情况,请检查看浏览器控制台网络一项,xhr请求是否走了代理,若请求代理请更正请求地址。使用webpack分支启动会遇见这种情况,请按照ajax配置解决此问题。vite分支默认请求线上 http://z3web.cn 不存在请求报错。