常见问题 #

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

node -v # 14.18.0

安装报错 #

• 使用npm i 安装报错

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

启动报错 #

• 脚本启动报错1

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

• 脚本启动报错2

以上出错是因为 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
  },
}

这里查看讲解文章

• 脚本启动成功，但是页面打不开？

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

请求报错 #

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