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