FastAPI 使用记录

  1. 安装
  2. 运行
    1. 使用 FastAPI CLI 启动
    2. 使用 uvicorn 启动
    3. 使用 python 启动
  3. 参考

安装

  • pip

    pip install "fastapi[standard]"
    
  • uv

    uv add "fastapi[standard]"
    

运行

使用 FastAPI CLI 启动

main.py

import sys
from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def status():
    return {"running": sys.argv[0]}
  • 开发环境

    fastapi dev main.py
    
  • 自定义地址、端口和日志级别

    fastapi dev main.py --host 127.0.0.1 --port 8000 --log-level warning
    

fastapi dev 默认开启热重载并监听 127.0.0.1fastapi run 是生产模式,默认关闭热重载并监听 0.0.0.0,部署时还应由反向代理或平台终止 HTTPS。

使用 uvicorn 启动

main.py

import sys
from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def status():
    return {"running": sys.argv[0]}
  • 启动

    uvicorn main:app
    
  • 自定义地址、端口、模式启动

    uvicorn main:app --host 127.0.0.1 --port 8000 --reload --log-level warning
    

使用 python 启动

main.py

import uvicorn
from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def status():
    return {"ok": 200}


if __name__ == "__main__":
    uvicorn.run("main:app")
  • 启动

    python main.py
    
  • 自定义地址、端口、模式启动

    import uvicorn
    from fastapi import FastAPI
    
    app = FastAPI()
    
    
    @app.get("/")
    def status():
        return {"ok": 200}
    
    
    if __name__ == "__main__":
        uvicorn.run(
            "main:app",
            host="127.0.0.1",
            port=8000,
            reload=True,
            log_level="warning",
        )
    

传入 reload=True 时使用导入字符串 "main:app",不要直接传 app 对象。host 也是字符串,不能写成未加引号的 IP 地址。


参考

FastAPI CLI
Uvicorn Settings


转载请注明来源,欢迎对文章中的引用来源进行考证,欢迎指出任何有错误或不够清晰的表达。

文章标题:FastAPI 使用记录

字数:303

本文作者:

发布时间:2025-10-30, 14:49:00

最后更新:2026-08-26, 21:18:00

原始链接:https://cnlnn.pages.dev/posts/fastapi-usage-notes/

版权声明: "署名-非商用-相同方式共享 4.0" 转载请保留原文链接及作者。