知识小屋

    安装与第一个接口

    这一节从零创建一个最小 FastAPI 项目。

    一、创建项目目录

    mkdir fastapi-demo
cd fastapi-demo

    二、创建虚拟环境

    虚拟环境用来隔离项目依赖，避免把所有 Python 包都装到系统环境里。

    Windows：

    python -m venv .venv
.\.venv\Scripts\activate

    macOS / Linux：

    python3 -m venv .venv
source .venv/bin/activate

    激活成功后，终端前面通常会出现 (.venv)。

    三、安装 FastAPI

    pip install "fastapi[standard]"

    fastapi[standard] 会安装 FastAPI 和常用标准依赖，包括开发启动命令需要的 FastAPI CLI。

    命令里的引号建议保留。不同终端对 [] 的处理不完全一样，加引号最稳。

    四、创建 main.py

    在项目根目录创建 main.py：

    from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def root():
    return {"message": "Hello FastAPI"}

    当前目录结构：

    fastapi-demo/
├── .venv/
└── main.py

    五、启动开发服务器

    fastapi dev main.py

    看到类似下面的地址就表示启动成功：

    Serving at: http://127.0.0.1:8000
API docs:  http://127.0.0.1:8000/docs

    打开浏览器访问：

    http://127.0.0.1:8000

    返回：

    {
    "message": "Hello FastAPI"
}

    六、修改代码试试热重载

    把 main.py 改成：

    from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def root():
    return {"message": "你好，FastAPI"}

    保存后刷新浏览器，不需要手动重启服务。fastapi dev 会自动热重载。

    七、再加一个接口

    @app.get("/ping")
def ping():
    return {"ok": True}

    完整代码：

    from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def root():
    return {"message": "你好，FastAPI"}


@app.get("/ping")
def ping():
    return {"ok": True}

    访问：

    http://127.0.0.1:8000/ping

    返回：

    {
    "ok": true
}

    八、开发和生产启动命令

    场景命令说明
    开发环境fastapi dev main.py自动热重载，适合本地开发
    生产环境fastapi run main.py不开启开发热重载，适合部署

    学习阶段主要使用 fastapi dev main.py。