# python-fastapi-study

**Repository Path**: xzs-ctrl/python-fastapi-study

## Basic Information

- **Project Name**: python-fastapi-study
- **Description**: fastapi框架学习
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-23
- **Last Updated**: 2026-05-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Python FastAPI Study

FastAPI 学习项目。

## 环境要求

- Python 3.10+
- 虚拟环境（venv）

## 快速开始

```bash
# 激活虚拟环境
source .venv/Scripts/activate

# 同步依赖
pip-sync requirements.txt

# 启动服务
uvicorn main:app --reload
```

## 依赖管理

项目使用 [pip-tools](https://github.com/jazzband/pip-tools) 管理依赖。

### 工作流程

```
requirements.in   (手动维护，只写直接依赖)
       ↓
  pip-compile      (自动编译)
       ↓
requirements.txt   (自动生成，锁定所有间接依赖版本)
       ↓
  pip-sync         (同步虚拟环境)
```

### 常用命令

```bash
# 编译 requirements.in → requirements.txt
pip-compile requirements.in

# 同步虚拟环境，使其与 requirements.txt 完全一致
pip-sync requirements.txt

# 新增依赖时，编辑 requirements.in 添加一行，然后重新编译
```

### 示例

`requirements.in` 内容：

```
fastapi
uvicorn
httpx
```

运行 `pip-compile requirements.in` 后，`requirements.txt` 会自动生成带锁定版本的所有依赖及其间接依赖。