由于 trendforge.devlive.top 访问受限，请切换到 trendforge.devlive.org 域名
5分钟快速开始 vue-fastapi-admin
基于 FastAPI + Vue3 + Naive UI 的现代化轻量管理平台，包含 RBAC 权限管理、JWT 鉴权等功能。
环境要求
支持的操作系统
运行环境
所需工具
克隆项目代码
Python 包管理
前端包管理
操作步骤
克隆项目代码
从 GitHub 克隆项目到本地。
git clone https://github.com/mizhexiaoxiao/vue-fastapi-admin.gitcd vue-fastapi-admin预期结果：：项目文件被下载到本地 vue-fastapi-admin 目录。
确保网络畅通，可以访问 GitHub。
启动后端服务 (FastAPI)
安装 Python 依赖并启动后端服务。
cd backenduv venvsource .venv/bin/activateuv pip install -r requirements.txtuvicorn app.main:app --reload --host 0.0.0.0 --port 8000预期结果：：看到类似 'Uvicorn running on http://0.0.0.0:8000' 的输出，表明后端服务已启动。
如果未安装 uv，可以使用 pip：创建虚拟环境 `python -m venv .venv`，激活后 `pip install -r requirements.txt`，然后启动。
启动前端服务 (Vue)
在新的终端窗口中安装前端依赖并启动开发服务器。
cd frontendpnpm installpnpm dev预期结果：：看到类似 'Local: http://localhost:3000/' 的输出，表明前端服务已启动。
如果未安装 pnpm，可以使用 npm：`npm install` 然后 `npm run dev`。
验证成功
访问前端应用并登录。
快速提示
项目同时提供了 Docker 快速启动方式，详见 README 中的 Docker 部分。
后端 API 文档地址为 http://localhost:8000/docs
前端开发服务器默认端口为 3000，后端为 8000，确保端口未被占用。
常见问题
后端启动失败，提示模块未找到。
确保已激活虚拟环境，并重新运行 `uv pip install -r requirements.txt` 或 `pip install -r requirements.txt`。
前端安装依赖失败。
尝试删除 `node_modules` 和 `package-lock.json` (或 `pnpm-lock.yaml`)，然后重新运行 `pnpm install`。
浏览器访问页面显示连接被拒绝。
检查后端和前端服务是否都已成功启动，并确认它们分别运行在 8000 和 3000 端口。检查防火墙或安全软件是否拦截了连接。
下一步
探索项目代码
查看目录结构，了解 FastAPI 和 Vue3 的集成方式。
阅读官方文档
深入了解 FastAPI、Vue3、Naive UI 和 Tortoise-ORM。
自定义与扩展
尝试修改菜单、用户或角色，体验 RBAC 和动态路由功能。
相关项目推荐
PanJiaChen/vue-element-admin
🎉 神奇的Vue后台管理系统 https://panjiachen.github.io/vue-element-admin
ElemeFE/element
一个基于Vue.js 2.0的Web界面组件库 （注：根据技术文档翻译规范，"UI Toolkit"在中文技术社区常译为"界面组件库"或"UI工具包"，此处采用更符合中文开发习惯的"界面组件库"；"for Web"明确指向Web端开发，采用"Web"直译保持技术准确性）
CorentinTh/it-tools
专为开发者打造的便捷在线工具集合，拥有卓越的用户体验。
vbenjs/vue-vben-admin
一个基于Vue3、Shadcn UI、Vite、TypeScript和Monorepo构建的现代化Vue管理面板。它速度极快！
qier222/YesPlayMusic
高颜值第三方网易云播放器，支持Windows/macOS/Linux系统
requarks/wiki
Wiki.js | 基于 Node.js 构建的现代化强大 Wiki 应用