跳至主要內容

基于React&AntdPro框架开发常见问题

holic-x...大约 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进行管理open in new window(切换不同的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