Python 異步 ORM 全解析，一文搞定！
作者：Ss肥魚
Tortoise-ORM 是一款 輕量級、異步、易上手 的 Python ORM，適用于 FastAPI、Sanic、Tornado 等異步 Web 框架。
你是否遇到這些問題？
- SQLAlchemy 太復雜，想找個輕量級 ORM？
- 需要在 FastAPI 里操作數據庫，但 SQLAlchemy 配置繁瑣？
- 想在異步項目中優雅地操作數據庫？
Tortoise-ORM 是一款 輕量級、異步、易上手 的 Python ORM，適用于 FastAPI、Sanic、Tornado 等異步 Web 框架。
本篇文章帶你 從入門到進階，徹底掌握 Tortoise-ORM！
目錄結構
tortoise_project/
│── main.py # 啟動應用，初始化數據庫
│── db.py # 負責數據庫連接
│── models.py # 定義 ORM 模型
│── crud.py # 封裝數據庫操作（增刪改查）
│── config.py # 配置數據庫信息
│── requirements.txt # 依賴包列表代碼拆分合理，結構清晰，方便擴展！
安裝 & 配置
(1) 安裝依賴
pip install tortoise-orm aiosqlite如果使用 MySQL：
pip install aiomysql如果使用 PostgreSQL：
pip install asyncpg(2) 配置數據庫信息（config.py）
DB_URL = "sqlite://db.sqlite3" # 這里可以改為 MySQL / PostgreSQL這樣做的好處：方便更換數據庫類型！
(3) 連接數據庫（db.py）
from tortoise import Tortoise
from config import DB_URL
async def init_db():
await Tortoise.init(
db_url=DB_URL,
modules={"models": ["models"]} # 告訴 ORM 去哪里找模型
)
await Tortoise.generate_schemas() # 自動創建表ORM 需要 init() 初始化數據庫，然后 generate_schemas() 自動建表。
定義 ORM 模型（models.py）
from tortoise.models import Model
from tortoise import fields
class User(Model):
id = fields.IntField(pk=True)
name = fields.CharField(max_length=50)
age = fields.IntField()
created_at = fields.DatetimeField(auto_now_add=True)
class Meta:
table = "users" # 指定數據庫表名ORM 方式定義表結構，避免手寫 SQL！
封裝數據庫操作（crud.py）
from models import User
# 插入數據
asyncdefcreate_user(name: str, age: int):
returnawait User.create(name=name, age=age)
# 查詢數據
asyncdefget_user(user_id: int):
returnawait User.get(id=user_id)
# 更新數據
asyncdefupdate_user(user_id: int, new_age: int):
user = await User.get(id=user_id)
user.age = new_age
await user.save()
# 刪除數據
asyncdefdelete_user(user_id: int):
user = await User.get(id=user_id)
await user.delete()封裝 CRUD，主邏輯更清晰，調用更方便！
啟動程序（main.py）
import asyncio
from db import init_db
from crud import create_user, get_user
asyncdefmain():
await init_db() # 連接數據庫
# 創建用戶
user = await create_user(name="Alice", age=25)
print(f"創建用戶：{user.name}，ID：{user.id}")
# 查詢用戶
found_user = await get_user(user.id)
print(f"查詢用戶：{found_user.name}，年齡：{found_user.age}")
# 運行主函數
asyncio.run(main())代碼拆分后，main.py 邏輯清晰，可隨時擴展！
進階操作：一對多 & 多對多
(1) 一對多關系（User → Post）
class Post(Model):
id = fields.IntField(pk=True)
title = fields.CharField(max_length=100)
user = fields.ForeignKeyField("models.User", related_name="posts") # 外鍵ForeignKeyField 定義外鍵關系，related_name 反向訪問！
(2) 多對多關系（User ? Course）
class Course(Model):
id = fields.IntField(pk=True)
name = fields.CharField(max_length=100)
users = fields.ManyToManyField("models.User", related_name="courses")多對多關系通過 ManyToManyField 輕松實現！
Tortoise-ORM vs 其他 ORM
ORM 框架 | 異步支持 | 輕量級 | 易用性 | 適用場景 |
Tortoise-ORM | ? 原生異步 | ? 輕量級 | ? 類 Django ORM | ? FastAPI / Sanic / 異步項目 |
SQLAlchemy | ?? 依賴 | ? 復雜 | ? API 復雜 | ? 復雜項目 |
Django ORM | ? 僅同步 | ?? 比較重 | ? 簡單 | ? Django 項目 |
- 異步項目 → 用 Tortoise-ORM
- 同步項目 → 用 Django ORM 或 SQLAlchemy
結語：Tortoise-ORM 讓異步數據庫操作更簡單！
Tortoise-ORM 是 FastAPI、Sanic 等異步 Web 框架的最佳 ORM 選擇！
語法簡單，API 直觀，學習成本低！
責任編輯：趙寧寧
來源：
Ssoul肥魚
