# fastapi-study

**Repository Path**: ooooinfo/fastapi-study

## Basic Information

- **Project Name**: fastapi-study
- **Description**: fastapi学习教程
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-01-20
- **Last Updated**: 2025-06-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FastAPI 学习项目

这是一个用于学习 FastAPI 的项目集合，主要包含一个完整的博客系统实现。

## 项目结构

```
fastapistudy/
├── blog/                # 博客系统主项目
├── study/              # FastAPI 学习示例
└── Light-Year-Admin-Template/  # 后台模板
```

## 博客系统 (blog/)

这是一个基于 FastAPI 和 MySQL 的现代化个人博客系统。

### 主要特性

- 前台
  - 文章展示
  - 分类浏览
  - 标签过滤
  - 评论功能
  - 用户注册/登录
  - 验证码支持

- 后台管理
  - 文章管理
  - 分类管理
  - 标签管理
  - 用户管理
  - 评论管理
  - 统计分析

### 技术栈

- 后端
  - FastAPI - 现代化的 Python Web 框架
  - SQLAlchemy - ORM
  - Pydantic - 数据验证
  - JWT - 用户认证
  - Jinja2 - 模板引擎
  - Pillow - 图片处理

- 前端
  - Bootstrap - UI 框架
  - jQuery - JavaScript 库
  - Light Year Admin - 后台模板

### 项目运行

1. 进入博客项目目录
```bash
cd blog
```

2. 创建虚拟环境
```bash
# 使用 venv
python -m venv blog
# 或使用 conda
conda create -n blog python=3.10
```

3. 安装依赖
```bash
pip install -r requirements.txt
```

4. 配置数据库
- 创建 MySQL 数据库
- 修改配置文件中的数据库连接信息
- 数据的初始化脚本位于 `blog/db/init_database.sql` 或  `blog/db/blog.sql` 

5. 运行项目
```bash
# 方式1
uvicorn main:app --reload
# 方式2
python main.py
```

## 学习示例 (study/)

包含了学习 FastAPI 过程中的各种示例代码和练习。

## 致谢


- [FastAPI](https://fastapi.tiangolo.com/) - 现代化的 Python Web 框架
- [Light Year Admin](http://lyear.itshubao.com/) - 优秀的后台管理系统模板
  - 作者：笔下光年
  - 使用版本：Light Year Admin v4