——小菜“大胖老师咱们文渊慧典的Web界面是用什么做的王大姐用的那个拖拽上传、一键识别、进度条走完下载看着挺高级的。是不是得请个前端工程师写好久”——大胖老师端起保温杯吹了吹热气“你猜那个界面的第一版原型二黑花了多长时间” ——小菜“一个月”——二黑推了推眼镜头也不抬“两天。用的是Gradio。”——小菜差点把嘴里的茶喷出来“两天就那个能拖拽、能显示进度条、能下载的完整界面怎么可能”——大胖老师笑了“怎么不可能。Gradio这东西说白了就是‘用Python写网页’。你写一个函数它自动给你生成一个界面。你以为我们请了前端团队不我们只是写了几十个Python函数每个函数套了一个Gradio壳。今天正好有空我给你开个小灶让你十分钟入门Gradio。学完你就知道王大姐用的那个熊猫图标背后藏着的就是这东西。”一、Gradio到底是个啥大胖老师的“微波炉理论”大胖老师在白板上画了一个微波炉旁边标注放进食物 → 按开始 → 热好端出来。“Gradio就是Python函数的微波炉。你写一个函数——输入什么输出什么——Gradio自动给它做一个操作面板输入框、按钮、输出框全给你配好。用户在前面操作函数在后面跑结果在前面显示。你完全不需要懂HTML、CSS、JavaScript。会写Python函数就会做Web界面。”小菜半信半疑“真有这么神”二黑打开笔记本电脑“试试就知道了。环境我已经配好了就装了一个gradio包。先从最蠢的例子开始。”二、环境准备比泡面还快二黑在终端里敲了一行命令屏幕上哗哗闪过几行安装信息前后不到三十秒。pip install gradio验证一下装没装上python -c import gradio as gr; print(✅ Gradio版本:, gr.__version__)“就这一个依赖。不需要装PyTorch不需要装Transformers不碰任何AI库。Gradio本身就是一个通用的Web界面框架跟AI没有绑定关系。你可以用它给任何Python函数做界面——计算器、文本处理、文件转换哪怕只是一个‘输入名字、输出你好’的打招呼函数。”大胖老师强调“我们今天不讲AI只讲界面。让你先感受一下把一个普通函数变成网页有多简单。”三、案例一超简单的文本翻转器——小菜的第一个Gradio应用“先来个最基础的。”二黑在编辑器里敲了几行代码把屏幕转向小菜“你写一个函数输入一段文本返回反转后的文本。就这一个函数别的什么都不用写。”小菜想了想敲了几行def reverse_text(text): 将输入文本反转 if not text: return 请输入一些文字 return text[::-1]“行了。”二黑接过键盘在函数下面加了几行“现在用Gradio给它套一个壳。”完整的代码不到二十行import gradio as gr def reverse_text(text): 将输入文本反转 if not text: return 请输入一些文字 return text[::-1] # 创建界面 demo gr.Interface( fnreverse_text, # 用哪个函数 inputsgr.Textbox(label输入文本, placeholder在这里打字...), # 输入组件 outputsgr.Textbox(label反转结果), # 输出组件 title 文本翻转器, description在左侧输入文字右侧立即看到反转效果, examples[[Hello], [Gradio 真简单], [123456789]] ) demo.launch()“跑一下。”二黑敲了python reverse_text.py终端里跳出一行地址http://127.0.0.1:7860。小菜在浏览器里打开页面上一个输入框、一个输出框下方还有三个示例按钮。他在输入框里打字输出框里的文字实时反转——“Hello”秒变“olleH”。“真的不用写HTML不用写CSS不用写JavaScript”小菜连问三遍。大胖老师端着保温杯慢悠悠地回了一句“Gradio帮你全干了。你写的只有那个反转函数别的都是自动生成的。”“Interface三要素你给我记住。”大胖老师在白板上写下fn——你的Python函数inputs——输入组件outputs——输出组件。“就这三样Gradio的核心API。掌握了Interface你就掌握了Gradio的八成功力。examples是预设示例用户点一下自动填入省得打字。Textbox里的placeholder是灰色提示文字告诉用户在这儿输入。这些细节都是用户体验的一部分。”四、案例二图片转灰度/翻转工具——小菜给王大姐做的第一个“产品”“文本反转太简单了来个实用的。”大胖老师从抽屉里拿出一张古籍扫描件的打印稿“王大姐经常要处理扫描件——有时候扫出来的图片方向反了有时候颜色太淡想转成灰度看看。你给她做个图片处理小工具能灰度化、能翻转。”小菜这回主动多了。他想起之前用PIL处理过图片知道PIL有convert和transpose方法。二黑在旁边提示了函数签名——输入有两个图片本身和一个操作选择。图片用gr.Image组件接收操作选择用gr.Dropdown下拉菜单。小菜写出核心函数from PIL import Image def process_image(image, operation): 对图片进行处理 if image is None: return None if operation 原图: return image elif operation 灰度: return image.convert(L) elif operation 水平翻转: return image.transpose(Image.FLIP_LEFT_RIGHT) elif operation 垂直翻转: return image.transpose(Image.FLIP_TOP_BOTTOM) else: return image然后用Interface包起来这次inputs是两个组件import gradio as gr demo gr.Interface( fnprocess_image, inputs[ gr.Image(typepil, label上传图片), gr.Dropdown( choices[原图, 灰度, 水平翻转, 垂直翻转], label选择操作, value原图 ) ], outputsgr.Image(label处理后图片), title️ 图片处理小工具, description上传图片选择操作实时预览效果, ) demo.launch()运行起来后小菜上传了一张古籍扫描件切换下拉菜单选“灰度”图片立刻变成黑白选“水平翻转”图片瞬间镜像。他把这个链接发给了王大姐。过了十分钟王大姐回了一条消息“这个好我以后扫反了不用重新扫了直接在你这个小工具里翻一下就行。省大事了”大胖老师看到消息笑着对小菜说“看到没你写的不是什么高深的技术就是一个简单的函数套了一个Gradio壳。但王大姐能用上能解决她的实际问题。这就是我们做技术的意义——不是写论文是让王大姐少跑一趟扫描仪。你在不知不觉中已经掌握了Gradio的几个核心技能。”他在白板上总结了一张表多输入处理——inputs用列表组件顺序对应函数参数顺序图片组件——gr.Image(typepil)让函数接收PIL对象方便处理下拉菜单——gr.Dropdownchoices列表value默认值自动触发——任何输入变化都会重新调用函数不需要点按钮。五、进阶彩蛋让按钮说了算——Interface vs Blocks小菜意犹未尽“大胖老师Interface是输入变了自动执行。那如果我想让用户填完之后点一个按钮才执行呢有时候用户还想改一改不想每改一个字就跑一遍。”二黑接过键盘“这个需求用Blocks实现。Blocks是Gradio的另一种API比Interface更灵活。你可以自己搭布局自己绑定事件。”他飞快地敲了一个带按钮的文本大写转换器import gradio as gr def to_uppercase(text): return text.upper() if text else with gr.Blocks() as demo: gr.Markdown(## 文本大写转换) text_input gr.Textbox(label输入文本, placeholder写点什么...) text_output gr.Textbox(label结果, interactiveFalse) btn gr.Button(转为大写, variantprimary) btn.click(fnto_uppercase, inputstext_input, outputstext_output) text_input.submit(fnto_uppercase, inputstext_input, outputstext_output) demo.launch()大胖老师解释两者区别“Interface像自动挡汽车——挂挡就走不用你管。适合简单场景输入输出一对一。Blocks像手动挡——你自己控制什么时候换挡。适合需要按钮、分步操作、复杂布局的场景。我们文渊慧典的界面最早用Interface快速验证后来功能多了就改成Blocks做精细化控制。你从Interface入门以后慢慢过渡到Blocks这条路很顺。”六、下课前的两个彩蛋彩蛋一一键分享公网链接。“王大姐在隔壁办公室想用你刚做的工具。你不需要把代码发给她不需要帮她配环境。”二黑在代码里加了一个参数把demo.launch()改成demo.launch(shareTrue)。重新运行终端里除了本地地址还多了一个https://xxxxx.gradio.live的公网链接。“把这个链接发给王大姐她直接在手机浏览器上就能用。Gradio帮你做了内网穿透省得你折腾Nginx、DNS那一套。”彩蛋二文渊慧典的界面就是这么搭起来的。小菜忽然问“那咱们文渊慧典的拖拽上传、进度条、下载按钮也是用Gradio做的”二黑点头“都是。拖拽上传是gr.File()组件进度条是gr.Progress()下载按钮是gr.File()的output模式。整个界面大概十几个组件用Blocks搭好布局每个组件绑定对应的处理函数。PDF解析函数、图像预处理函数、版面分析函数、OCR识别函数、后处理函数——每个函数都是一个Python函数Gradio给它们各自穿上UI的外衣再用Blocks串成一条流水线。”大胖老师补充“所以你现在知道了文渊慧典的技术含量不在Gradio上。Gradio只是我们的‘外壳’。真正的核心是那些处理古籍的函数——PDF拆页、自适应二值化、版面分析、SVTR识别、阅读顺序重建。这些才是我们花了三年打磨的东西。Gradio只是帮我们把它们包装成了王大姐能看懂的样子。”七、小结小菜学会了什么大胖老师在白板上画了一张总结表技能具体内容Interface三要素fn inputs outputsGradio的最简API常用组件Textbox文本输入输出、Image图片上传与显示、Dropdown下拉菜单示例数据examples一键填充方便用户快速体验多输入处理inputs用列表顺序与函数参数严格对应事件绑定Blocks btn.click实现“点击按钮才执行”一键分享shareTrue生成公网链接王大姐手机也能用小菜合上笔记本感慨地说“原来做一个Web界面可以这么简单。我一直以为前端很复杂要学HTML、CSS、JavaScript还得会React或Vue。没想到一个pip install加几行Python代码就能把函数变成网页。以后我再写什么工具第一时间想到的就是给它套一个Gradio壳。”大胖老师端起保温杯喝了一口“这就是我们选Gradio的原因。不是因为它最强——论性能和定制化专业前端框架当然更灵活。但它有一个任何框架都比不上的优势它的学习成本低到泥土里。我们实验室的研究生从第一次摸Python到做出能用的Web界面只需要一天。这让我们能把几乎所有精力都投在古籍OCR的核心算法上而不是浪费在写界面上。技术就应该这样——把复杂的留给自己把简单的留给别人。”小菜已经在心里盘算着下一个要给王大姐做什么工具了。