《Python Web 开发从入门到实践（FastAPI+Bootstrap）》1-Python概述

Python概述教材第1章Python概述与生态发展历程🐍起源：GuidovanRossum设计，1991年发布首版。特点是简洁易懂、完全开源。📈Web演进：早期：Zope(同步阻塞)经典：Django/Flask现代：FastAPI(异步非阻塞，高性能)生态优势💡跨领域整合：不仅仅是后端语言。无缝集成数据科学、AI模型与自动化运维，拓宽Web应用边界。📊TIOBE排名：约2022年超越Java/C成为全球最受欢迎语言。适合构建复杂的数据驱动型Web应用。“人生苦短，我用Python”PythonWeb主流框架对比特性/维度DjangoFlaskFastAPI设计哲学大而全，一站式解决方案极简轻量，核心功能+第三方扩展高性能+标准化，异步优先核心协议WSGI（同步阻塞）WSGI（同步阻塞）ASGI（异步非阻塞）核心优势内置ORM、表单验证、后台管理高度定制化，学习成本低高并发、自动数据验证、原生OpenAPI文档适用场景企业级CMS、全栈应用、快速开发小型服务、定制化高的轻量应用高并发API、微服务、AI模型部署、实时通信性能表现常规同步性能，满足通用场景同Django，依赖扩展优化接近Node.js/Go，低资源消耗处理海量并发总结：FastAPI在性能、开发效率和架构灵活性之间取得了极佳的平衡。它既具备媲美Node.js和Go的运行效率，又保留了Python的高开发效率，是构建现代化、高可靠性Web应用的首选方案本章核心任务在Windows操作系统下搭建规范统一的PythonWeb开发环境。Python安装与配置虚拟环境(venv)管理VSCode编辑器配置首个FastAPI应用离线SwaggerUI配置（选学）下载Python安装程序1.访问官网打开浏览器访问：/downloads/windows/2.选择版本为了获取最新特性与安全更新，推荐安装3.10以上版本。📍本书教学版本：Python3.13.73.下载文件点击下载Windowsinstaller(64-bit)📥WindowsInstaller(64-bit)StableReleases安装与PATH配置⚠️关键步骤：勾选PATH选项☑️Addpython.exetoPATH（务必在点击"InstallNow"之前勾选此项）为什么要勾选？这就好比在操作系统的“通讯录”里登记了Python的地址。勾选后，无论在任何目录下打开命令行，系统都能直接识别并执行`python`命令。否则，你必须输入冗长的完整安装路径。验证Python与pip安装完成后，需要通过命令行验证环境是否配置正确。C:\Users\User>python--versionPython3.13.7C:\Users\User>pip--versionpip23.0.1from...(python3.13)C:\Users\User>_💡提示：Win+R输入cmd即可打开命令提示符。创建虚拟环境为什么需要虚拟环境？Python虚拟环境=吃火锅的“一人一锅”模式不用虚拟环境：所有人吃一口大锅（全局Python环境），有人要清汤（依赖库1.0版），有人要特辣（依赖库2.0版），汤底混在一起，谁的需求都满足不了；用虚拟环境：每人一口独立小锅（虚拟环境），你想涮清汤就涮清汤，我想煮特辣就煮特辣，口味互不影响，各自吃得舒服。Python虚拟环境的作用为每个项目创建一个独立的python“工具箱”（venv）。确保项目间互不干扰，环境纯净。项目目录与切换首先，我们需要创建一个专门的文件夹作为项目根目录，并进入该目录。1.创建目录在D盘（或合适位置）新建文件夹PythonWeb2.切换命令D:

(切换到D盘)cdPythonWeb

(进入项目文件夹)创建venv在项目根目录下，执行以下命令来创建虚拟环境。python-mvenvvenv解析：•-mvenv:运行Python内置的venv模块•venv:指定创建的虚拟环境文件夹名称执行结果：PythonWeb/└──venv/(包含独立解释器与库)激活venv虚拟环境必须激活后才能使用。D:\PythonWeb>.\venv\Scripts\activate(venv)D:\PythonWeb>_✅看到(venv)前缀，说明你已成功进入独立的“工具箱”模式！安装FastAPI与Uvicorn⚡FastAPI核心Web框架，负责路由与业务逻辑。🦄Uvicorn高性能ASGI服务器，负责运行应用。#一次性安装所有依赖pipinstall"fastapi[all]"💡为什么使用"fastapi[all]"?自动安装fastapi框架本身自动安装uvicorn服务器自动安装常用可选依赖（如email-validator,pydantic-settings等）使用清华镜像源如果下载速度较慢，推荐使用国内镜像源加速安装。pipinstall"fastapi[all]"-i/simple🚀加速技巧后续安装任何Python库时，均可添加此参数。这能显著提升下载速度并避免因网络超时导致的安装失败。piplist检查安装完成后，验证核心库是否已正确安装。(venv)D:\PythonWeb>piplistPackageVersion------------------------fastapi0.109.0pydantic2.6.0uvicorn0.27.0...✅确认fastapi与uvicorn在列表中，即表示环境就绪。安装编辑器VisualStudioCode（VSCode）

从命令行迈向现代化集成开发环境(IDE)。🆓开放生态微软开发，免费开源，跨平台支持。⚡高效内核轻量级架构，启动迅速，资源占用低。🧩强大扩展代码高亮、智能提示、断点调试一应俱全。下载与安装VSCode1.获取安装包访问官网下载最新稳定版：/2.安装建议在“选择附加任务”步骤，建议勾选所有选项，以便右键快速打开项目。SelectAdditionalTasks☑️Createadesktopicon☑️Add"OpenwithCode"action...☑️RegisterCodeasaneditor...☑️AddtoPATH(requiresrestart)安装Python与Pylance扩展核心扩展是VSCode成为强大PythonIDE的关键。🐍

Python

Microsoft必装基础扩展提供代码高亮、智能提示、格式化与调试等核心功能。⚡

Pylance

Microsoft高性能语言服务器通常自动随Python扩展安装。提供极致的类型检查与代码补全体验。推荐扩展与语言包🤖TraeAI基于大模型的AI编程助手，支持代码补全、解释与错误修复。🌏Chinese(Simplified)LanguagePack界面汉化。安装后需在命令面板配置DisplayLanguage为zh-cn。🎨MaterialIconTheme为文件和文件夹提供美观直观的图标，提升项目管理体验。选择虚拟环境解释器确保VSCode使用的是项目虚拟环境，而非全局Python。main.py...Python3.13.7('venv':venv)如何手动选择？1.按Ctrl+Shift+P打开命令面板。2.输入Python:SelectInterpreter。3.选择带有('venv':venv)标识的选项。终端环境一致性在VSCode集成终端中执行命令时，必须确保处于虚拟环境中。终端1:powershell(venv)D:\PythonWeb>pipinstall......⚠️注意：如果未出现(venv)，请关闭终端重新打开，或手动激活。编写第一个FastAPI应用新建main.py，输入以下代码：fromfastapiimportFastAPIapp=FastAPI()@app.get("/")asyncdefread_root():return{"Hello":"World"}核心概念：1.导入与实例化：创建应用对象app。2.路由注册：@app.get("/")定义了根路径的处理方式。3.异步函数：asyncdef支持高并发处理。启动Uvicorn服务器代码编写完成后，需要启动服务器来运行应用。(venv)D:\PythonWeb>uvicornmain:app--reloadINFO:Uvicornrunningon:8000(PressCTRL+Ctoquit)命令解析：•main:Python文件名(main.py)•app:FastAPI实例对象名•--reload:热重载模式，代码修改后自动重启，开发神器！浏览器验证打开浏览器，访问:8000⚪⚪⚪____________________________________{"Hello":"World"}🎉恭喜！你的环境配置完全正确。局域网访问配置如何让手机访问？默认情况下，服务仅监听本地回环地址()。若需局域网访问，需监听。操作步骤1.Ctrl+C停止当前服务。2.执行命令：uvicornmain:app--reload--host3.手机浏览器访问电脑的局域网IP(如192.168.x.x:8000)。📡Router(局域网)💻

↔️

📱下载SwaggerUI资源我们需要获取SwaggerUI的静态文件包。1.访问GitHubRelease页面/swagger-api/swagger-ui/releases2.下载源码包下载最新的zip压缩包(如swagger-ui-5.28.0.zip)。3.提取核心文件解压后，找到dist文件夹。我们将只使用这个文件夹里的内容。组织static目录将dist内容复制到项目的静态资源目录中。PythonWeb/├──venv/├──main.py└──static/└──swagger-ui/├──swagger-ui.css├──swagger-ui-bundle.js└──...(fromdist)📂操作步骤1.新建static文件夹。2.在其中新建swagger-ui文件夹。3.将dist内所有文件粘贴进去。SwaggerUI离线化概述默认情况下，FastAPI的交互式文档依赖互联网CDN。为了稳定性，我们将其离线化。☁️默认模式(Online)依赖CDN加载CSS/JS。网络受限或断网时，文档无法加载。💾离线模式(Local)静态资源本地托管。无论是否有网，文档稳定可用。main.py离线文档代码修改main.py，加载本地静态文件。#1.禁用默认文档app=FastAPI(docs_url=None,redoc_url=None)#2.挂载静态目录app.mount("/static",StaticFiles(directory="static"),name="static")#3.自定义文档路由@app.get("/docs",include_in_schema=False)asyncdefcustom_swagger_ui_html():returnget_swagger_ui_html(openapi_url=app.openapi_url,title=app.title+"-SwaggerUI",swagger_js_url=