1. 搭建FastAPI+Poetry项目

一、使用官方推荐，采用独立安装脚本安装Poetry[2.2.1]

官方安装脚本可能从国外服务器下载，国内用户可能会遇到网络延迟。我们可以使用国内镜像来安装

1. 在PowerShell中执行以下命令设置PyPI镜像(使用清华镜像)：

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

2. 在PowerShell中运行安装命令：

(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | python -

这样Poetry就安装成功了

3. 按提示执行如下指令设定环境变量

[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";C:\Users\admin\AppData\Roaming\Python\Scripts", "User")

4. 安装完成后，重启Powershell验证是否成功

poetry --version

二、从零开始搭建FastAPI

1. 初始化Poetry项目

poetry init

2. 安装核心依赖
   使用 poetry add 命令安装FastAPI和ASGI服务器（如Uvicorn）。推荐将Uvicorn的标准版本安装为开发依赖，因为它通常仅用于开发环境

poetry config virtualenvs.in-project true
poetry source add --priority=primary aliyun https://mirrors.aliyun.com/pypi/simple/
poetry source add --priority=supplemental tuna https://pypi.tuna.tsinghua.edu.cn/simple/
poetry add fastapi
poetry add pydantic_settings
poetry add uvicorn[standard] --group dev

3. 创建项目文件，并将项目路径添加到环境变量PYTHONPATH, 并在启动文件main.py中添加如下代码

from fastapi import FastAPI
from fastapi.middleware.cors import CORSMiddleware
from app.core.config import settings


# 创建FastAPI应用实例
app = FastAPI(
    title=settings.APP_NAME,
    debug=settings.DEBUG
)

# 配置CORS中间件
app.add_middleware(
    CORSMiddleware,
    allow_origins=settings.CORS_ORIGINS,
    allow_credentials=True,
    allow_methods=["*"],
    allow_headers=["*"],
)


# 注册路由
@app.get("/")
async def root():
    return {"message": "Hello World", "environment": settings.ENVIRONMENT}


if __name__ == "__main__":
    import uvicorn
    uvicorn.run("app.main:app", host="127.0.0.1", port=8000, reload=True)

4. 运行代码后可发现后端项目正常运行
   

引用1 Poetry官网
引用2 FastAPI官网