0 项目选择的原因
在Vue3 Admin 框架中我更偏向于
SoybeanAdmin，界面做的优雅，很多up推荐过，且他们活跃度很高、周边生态越来越完善。正好在soybean-admin 的生态里看到有大佬已经集成了fastapi，果断用它来重构我的项目。前端页面效果图如下：
1 前后端安装
具体项目的介绍，请点击上面的项目文档里看它的简介。重点是看快速开始的那块。这里python的版本大于3.10，别担心3.12、3.13的版本过高，亲测都可以跑。
1 环境安装
- git : 你需要git来克隆和管理项目版本。安装教程
- NodeJS : >=18.12.0，推荐 18.19.0 或更高。安装教程
- pnpm: >= 8.7.0，推荐最新版本。
- python: >= 3.10
这里的nodejs 安装教程你可以用官方提供的方式。或者你可以直接到nodejs官网里下载，选择好你对应的系统和位数(如下图)，下载安装包即可。正常你点击windows安装包/macos安装包 后，就自动帮你下载了。然后点击安装，下一步下一步即可，最后再配下全局环境，别忘了在命令行里输入node -v ，测试一下，验证是否配置成功。windows系统是python直接到官网下载，大于3.10的版本，一步步安装即可。最后在命令行下输入：python --version 、pip --version ，有对应的版本号即可。我用的mac mini ，它自带python ，可以在命令行Python3 --version 看下版本，我当时看python的版本 小于3.10，需要更新一下版本，这里更新方式也是比较简单的，不细说了。确保git、python、node都安装好后，在进行下一步。
2 拉取代码、安装依赖
先从github中拉取代码。
bash
git clone https://github.com/sleep1223/fast-soy-admin拉取好代码后，使用ide打开该项目，准备安装前后端的依赖
1 pip安装依赖
选中项目根目录，右键找到终端，假如需要需要虚拟环境分隔的话，先建好虚拟环境(你嫌弃麻烦的话，推荐使用PyCharm)，不需要隔离的话，直接使用全局就好了，pip install -r requirements.txt 。重点来了：用pip安装库的朋友注意了呀， 我安装的是python3.13 ，当时用pip安装对应的依赖时(注意：这里我没用pdm install 或者 poery install 的方式安装)，它总是提示我某个库安装失败，最后查到了个偏门的博客，根据他说的，我安装了rust才没问题)，假如你遇到一个偏门的报错，有概率是这个问题。
可以在PyCharm中设置中找到解释器，进去后，先添加本地解释器，新建如下图的虚拟环境，确定好后。你需要在这个项目中绑定这个虚拟环境，下拉选择解释器。确定，等待加载一会就可以了。 
2 pnpm安装依赖
cd web && pnpm i
2 运行项目
1 后端运行
根目录命令行：python或者python3 run.py。或者使用pycharm 这类ide 的，直接进入run.py 中，点击那个开启按键，也可以运行。注意：这里数据库默认用sqlite，所以无需配置，若是你想改为mysql这类的，请在env文件里改一下即可，别忘了安装对应的连接器哦。
2 前端运行
进入web目录，输入命令pnpm dev。或者在package包里找到dev，点击运行即可。进入到登录页后，点击确认，然后登录到首页就算成功了。如不清楚请对应一开始的配图。
3 总结
这里前后端的安装较为简单，只需要耐心的确保环境、拉取代码、依赖的安装等一步步的都没问题即可。你可能有疑惑，一般开源项目里都会给你个sql文件，让你初始化一下，为啥这里不需要呢，其实在我们启动python时，作者已经顺带的把初始化数据库、生成初始化的rbac的表和对应的数据的活做好了。