fastapi-local-dev

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

FastAPI Local Dev

FastAPI 本地开发

  • Dev:
    uvicorn app.main:app --reload
  • Imports: run from repo root; use
    python -m uvicorn ...
    or
    PYTHONPATH=.
  • WSL:
    WATCHFILES_FORCE_POLLING=true
    if reload misses changes
  • Prod:
    gunicorn app.main:app -k uvicorn.workers.UvicornWorker -w <n> --bind :8000
Anti-patterns:
  • --reload --workers > 1
  • PM2
    watch: true
    for Python
References:
references/
.
  • 开发环境:
    uvicorn app.main:app --reload
  • 导入配置:从仓库根目录运行;使用
    python -m uvicorn ...
    PYTHONPATH=.
  • WSL 环境:如果热重载未检测到更改,设置
    WATCHFILES_FORCE_POLLING=true
  • 生产环境:
    gunicorn app.main:app -k uvicorn.workers.UvicornWorker -w <n> --bind :8000
反模式:
  • --reload --workers > 1
    (同时使用热重载和多 worker)
  • Python 项目中使用 PM2 设置
    watch: true
参考文档:
references/
.