Bug 解决 | 前端框架初始化错误

首先，遇到报错时，请先认真阅读完整的报错信息，然后去百度错误信息或者询问 AI。

对于前端项目，如果初始化的过程报错或者无法正常启动。大概率是本地环境、依赖版本和教程不一致，或者是文件权限问题。

如果是权限问题，可以使用管理员权限、或者 sudo 命令（Mac 用户）来执行安装依赖、启动项目等命令。

1、阅读官方文档

例如，某项目使用的前端框架 Ant Design Pro 在持续更新，因此要以官方文档最新的初始化命令为主。

只要知道去看官方文档，你就能少走很多坑。

如果跟着视频做报错了，那么先去看最新官方文档上的命令和用法，或者切换文档版本为和视频一致。

24 年 2 月后，Ant Design Pro 的官方脚手架不再提供 umi@3 的选项，创建项目运行后也不再会看到 umi ui，这都是正常的，不要慌，完全不影响后续学习。

记住，框架会变化，我们学习的重点是思路和方法，不要默守陈规。

如果还有报错，那么就把错误信息贴到百度去查询。

如果还有报错，去框架的 Github Issues 区去搜一下：
Issues · ant-design/ant-design-pro · GitHubhttps://github.com/ant-design/ant-design-pro/issues99% 你遇到的问题别人也遇到过，而且大多数情况下都有对应的解决方案。

框架更新后，如果你还想跟视频教程的操作保持一致，那么可以使用老版本的框架呀！

比如 Ant Design Pro 框架，如果你还想用 umi@3 和 umi ui 怎么办呢？

更新后的框架不能满足需求，那我们用更新前的不就好了？？？

执行命令安装老版本的脚手架：

javascript 复制代码

npm i @ant-design/pro-cli@3.1.0 -g

然后使用 pro -v 查看版本号，保证是 3.1.0，即可出现 umi@3 的选项：

选择框架版本时，一定要选 v3！！！使用 v4 版本不支持 umi ui 悬浮按钮。

记住，解决问题的方法有很多，没有解决不了的问题。

希望大家灵活一点、多自主思考。任何教程都有保质期，学会阅读官方文档、通过各种渠道自主解决问题，才能让你之后的编程学习风雨无阻！

刚开始遇到这类问题可能会很懵逼，但一定要尝试自己解决，并且记录自己的解决过程和结果，经过长时间的积累，面对各种 Bug 你都不会虚的。

**以上就是本次的学习分享，希望对大家有所帮助，****关注我！**不定期分享有用干货！！！

如果有疑问的可以评论提出来~