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