基于React&AntdPro框架开发常见问题
...大约 2 分钟
基于React&AntdPro框架开发常见问题
Antd Pro登录后主页白屏
20240505
排查思路:查看官网issue方案:https://github.com/ant-design/ant-design-pro/issues
框架升级问题:24年2月后,AntDesignpro 的官方脚手架不再提供umi@3 的选项,创建项目运行后也不再会看到umiuì。但是官网升级之后其要求的node、npm版本也跟着要升级,否则可能出现白屏现象
例如使用低版本的node(16)、npm(8) 直接引入官网AntdPro框架,发现没有umi@3版本选项,说明官网框架升级直接默认使用了umi@4,但是基于这个版本的脚手架通过npm run start启动后发现主页白屏,F12提示是React not defined。则有可能是框架和项目环境依赖不兼容导致,升级了node、npm版本之后可以正常显示(如果npm版本要升级则要求node也要联动升级才行)
node升级可以使用nvm进行管理(切换不同的node版本):需要安装nvm,然后通过nvm安装node、切换node版本
npm升级执行指令:npm -v 查看版本;npm install -g npm@latest 更新到最新版本
类似地,不只是创建的时候可能会出现这个问题,在直接运行低版本antd pro脚手架项目的时候,登录之后页面白屏,也考虑是项目版本和环境依赖兼容问题
如果框架更新之后无法满足开发需求,则使用umi@3版本:(确保是3.1.0版本)
# 执行命令安装老版本的脚手架
npm i @ant-design/pro-cli@3.1.0 -g
# 执行指令查看版本号(确保是3.1.0版本)
pro -v
# 然后创建项目查看是否提供umi版本的选择
- 使用umi@4还是umi@3?
- 要全量的还是一个简单的脚手架?
# 如果是更新的版本提示是创建一个simple还是complete版本,选择后就直接拉取代码,不会提示umi3选项
注意选择框架版本的时候要选择umi3,umi4版本不支持umi ui悬浮按钮
其他常见问题解决
Powered by Waline v3.1.3