【亲测免费】 基于开源项目vue-fastapi-admin的常见问题解决方案

一、项目基础介绍

vue-fastapi-admin 是一个基于现代化前后端分离架构的开源管理平台，它融合了 FastAPI（一个高性能的异步 Web 框架）和 Vue3（一个渐进式 JavaScript 框架），同时使用 Naive UI 作为前端组件库。项目适用于快速搭建中小型应用，并提供了 RBAC 权限管理、动态路由和 JWT 鉴权等特性。

主要编程语言

• 后端：Python 3.11
• 前端：JavaScript (Vue.js)

二、新手常见问题与解决方案

问题一：如何快速启动项目？

问题描述： 新手在获取项目代码后，不清楚如何正确地启动整个项目。

解决步骤：

1. 确保已安装 Docker 环境（推荐使用 Docker 启动项目，以简化环境配置）。
2. 使用以下命令拉取项目镜像：

   docker pull mizhexiaoxiao/vue-fastapi-admin:latest
   

3. 启动容器：

   docker run -d --restart=always --name=vue-fastapi-admin -p 9999:80 mizhexiaoxiao/vue-fastapi-admin
   

4. 访问 http://localhost:9999，使用默认的用户名 admin 和密码 123456 登录。

问题二：如何使用 Poetry 管理后端依赖？

问题描述： 新手可能不熟悉使用 Poetry 这个依赖管理工具。

解决步骤：

1. 安装 Poetry，可以参考官方文档：https://python-poetry.org/docs/#installation（请忽略链接，直接访问官网或搜索相关教程）。
2. 在项目根目录下打开终端，执行以下命令创建虚拟环境并安装依赖：

   poetry shell
   poetry install
   

3. 启动服务，执行以下命令：

   make run
   

   或者直接使用 Poetry 启动：

   poetry run run.py
   

问题三：如何启动前端项目？

问题描述： 新手不清楚如何启动前端项目，或者遇到了前端依赖安装问题。

解决步骤：

1. 进入前端目录：

   cd web
   

2. 安装 Node.js 环境和依赖管理工具 pnpm（推荐使用 pnpm，也可以使用 npm）：

   npm i -g pnpm
   pnpm i
   

3. 启动前端开发服务器：

   pnpm dev
   

4. 访问 http://localhost:3000 查看前端界面。

通过以上步骤，新手可以顺利地启动和运行 vue-fastapi-admin 项目，并开始进一步的开发工作。