目錄一、Conda 虛擬環(huán)境配置二、安裝核心依賴(lài)三、編寫(xiě)最簡(jiǎn)啟動(dòng)代碼四、三種項(xiàng)目啟動(dòng)方式五、項(xiàng)目訪(fǎng)問(wèn)與接口文檔六、高頻報(bào)錯(cuò)快速解決一、Conda 虛擬環(huán)境配置使用獨(dú)立虛擬環(huán)境隔離項(xiàng)目依賴(lài)避免全局環(huán)境沖突這里以3.12版本為例終端執(zhí)行以下命令# 創(chuàng)建虛擬環(huán)境 conda create -n fastapi_env python3.12 # 激活虛擬環(huán)境 conda activate fastapi_env # 退出虛擬環(huán)境備用命令 conda deactivate二、安裝核心依賴(lài)激活環(huán)境后安裝 FastAPI 框架和 uvicorn 運(yùn)行服務(wù)器指定穩(wěn)定版本規(guī)避兼容問(wèn)題# 安裝標(biāo)準(zhǔn)版FastAPI pip install fastapi[standard] # 指定版本安裝可選穩(wěn)定推薦 pip install fastapi0.115.12 # 安裝運(yùn)行服務(wù)器 pip install uvicorn0.34.2三、編寫(xiě)最簡(jiǎn)啟動(dòng)代碼新建main01.py寫(xiě)入基礎(chǔ)項(xiàng)目代碼包含根接口和服務(wù)啟動(dòng)配置from fastapi import FastAPI import uvicorn app FastAPI() # 基礎(chǔ)根接口 app.get(/) def read_root(): return {Hello: World} # 項(xiàng)目啟動(dòng)入口 if __name__ __main__: # 熱更新調(diào)試模式本地開(kāi)發(fā)專(zhuān)用 uvicorn.run(main01:app, host0.0.0.0, port8000, reloadTrue, debugTrue)核心要點(diǎn)main01:app必須嚴(yán)格對(duì)應(yīng)「文件名:實(shí)例變量名」拼寫(xiě)錯(cuò)誤會(huì)直接啟動(dòng)失敗。四、三種項(xiàng)目啟動(dòng)方式三種方式按需選用均支持熱更新開(kāi)發(fā)# 方式1直接運(yùn)行腳本最常用 python main01.py # 方式2終端uvicorn命令啟動(dòng) uvicorn main01:app --reload # 方式3FastAPI官方調(diào)試啟動(dòng) fastapi dev main01.py五、項(xiàng)目訪(fǎng)問(wèn)與接口文檔項(xiàng)目啟動(dòng)成功后可直接訪(fǎng)問(wèn)以下地址FastAPI 自帶自動(dòng)生成接口文檔項(xiàng)目根地址http://127.0.0.1:8000交互式調(diào)試文檔推薦開(kāi)發(fā)使用http://127.0.0.1:8000/docs標(biāo)準(zhǔn)規(guī)范文檔適合查閱http://127.0.0.1:8000/redoc六、高頻報(bào)錯(cuò)快速解決針對(duì)訪(fǎng)問(wèn)URL報(bào)錯(cuò)、頁(yè)面打不開(kāi)問(wèn)題匯總核心解決辦法文檔/接口無(wú)法訪(fǎng)問(wèn)優(yōu)先檢查項(xiàng)目是否真正啟動(dòng)成功、8000端口是否被占用模塊不存在報(bào)錯(cuò)確認(rèn)已激活虛擬環(huán)境依賴(lài)安裝完整啟動(dòng)報(bào)錯(cuò)核對(duì)文件名、main01:app拼寫(xiě)區(qū)分大小寫(xiě)