

今天云朵君要给大家介绍一个能极大提升开发效率的神器——NiceGUI。

你是否也曾有这样的烦恼:
“这个Python数据分析脚本跑得不错,但怎么让非技术同事也能方便地使用?”“想做个简单的内部工具,但一想到要学HTML、CSS、JavaScript就头大…”“前后端联调太费时间了,能不能只用Python搞定一切?”
如果你有这些困扰,那么今天介绍的 NiceGUI 可能就是你的最佳解决方案。
简单来说,NiceGUI 是一个纯Python的Web UI框架。它允许你只用Python代码就创建出功能完整、界面美观的Web应用程序。
想象一下:你像平时一样写Python函数,但这些函数可以直接变成网页上的按钮、输入框、图表。用户点击按钮时,你的Python函数自动执行,结果实时显示在网页上。
这听起来像魔法,但原理其实很聪明:NiceGUI在底层使用了成熟的Vue.js框架(通过Quasar),但把所有前端复杂性都封装起来了。你只需要调用Python函数,它自动生成对应的HTML/CSS/JavaScript。
让我们从一个简单的温度转换器开始,感受NiceGUI的魅力。
只需要Python 3.7+和一行命令:
# 安装NiceGUIpip install nicegui是的,就这么简单!不需要安装Node.js,不需要配置Webpack,不需要理解npm包管理。
创建一个名为temperature_converter.py的文件:
from nicegui import ui# 1. 创建温度转换函数(纯Python逻辑)defcelsius_to_fahrenheit(celsius: float) -> float:"""将摄氏度转换为华氏度"""return (celsius * 9/5) + 32deffahrenheit_to_celsius(fahrenheit: float) -> float:"""将华氏度转换为摄氏度"""return (fahrenheit - 32) * 5/9# 2. 创建Web界面组件# 标题ui.label('🌡️ 温度转换器').classes('text-2xl font-bold text-blue-600')# 使用行布局,让两个输入框并排显示with ui.row().classes('w-full gap-4'): celsius_input = ui.input( label='摄氏度 (°C)', placeholder='输入摄氏度数值', validation={'请输入有效数字': lambda value: value == ''or value.replace('.', '', 1).isdigit()} ).classes('w-48') fahrenheit_input = ui.input( label='华氏度 (°F)', placeholder='输入华氏度数值', validation={'请输入有效数字': lambda value: value == ''or value.replace('.', '', 1).isdigit()} ).classes('w-48')# 3. 定义交互函数defupdate_fahrenheit():"""当摄氏度输入变化时,更新华氏度"""try: celsius = float(celsius_input.value) if celsius_input.value else0 fahrenheit = celsius_to_fahrenheit(celsius) fahrenheit_input.value = f'{fahrenheit:.2f}'except ValueError:# 输入无效时清空 fahrenheit_input.value = ''defupdate_celsius():"""当华氏度输入变化时,更新摄氏度"""try: fahrenheit = float(fahrenheit_input.value) if fahrenheit_input.value else0 celsius = fahrenheit_to_celsius(fahrenheit) celsius_input.value = f'{celsius:.2f}'except ValueError: celsius_input.value = ''# 4. 绑定事件:实时转换(无需点击按钮)celsius_input.on('update:model-value', lambda e: update_fahrenheit())fahrenheit_input.on('update:model-value', lambda e: update_celsius())# 5. 添加说明卡片with ui.card().classes('mt-4 w-full'): ui.label('💡 使用说明').classes('text-lg font-semibold') ui.label('• 在任意输入框中输入温度值') ui.label('• 另一输入框会自动实时转换') ui.label('• 支持小数输入,自动保留两位小数')# 6. 运行应用ui.run( title='温度转换器', favicon='🌡️', reload=True# 开发模式:代码修改后自动重载)python temperature_converter.py打开浏览器访问 http://localhost:8080,你会看到一个功能完整的温度转换器!
关键点解析:
ui.input() :创建一个文本输入框,就像HTML的<input>标签.classes() :应用CSS类(使用Tailwind CSS语法),控制样式on() 方法 :绑定事件处理器,实现实时响应ui.row() :创建水平布局容器ui.card() :创建卡片式容器,增强视觉效果让我们再来看一个更实用的例子,展示NiceGUI的响应式能力:
from nicegui import uifrom datetime import datetime# 创建响应式应用ui.label('📝 实时文本分析器').classes('text-2xl font-bold text-purple-600')# 创建文本输入区域text_area = ui.textarea( label='请输入文本', placeholder='开始输入,查看实时分析...', on_change=lambda e: None# 占位,实际通过事件处理).classes('w-full h-40')# 创建指标显示卡片with ui.row().classes('w-full gap-4 mt-4'): char_card = ui.card().classes('flex-1')with char_card: ui.label('字符数').classes('text-sm text-gray-500') char_count = ui.label('0').classes('text-3xl font-bold text-green-600') word_card = ui.card().classes('flex-1')with word_card: ui.label('单词数').classes('text-sm text-gray-500') word_count = ui.label('0').classes('text-3xl font-bold text-blue-600') line_card = ui.card().classes('flex-1')with line_card: ui.label('行数').classes('text-sm text-gray-500') line_count = ui.label('0').classes('text-3xl font-bold text-red-600')# 添加分析时间显示update_time = ui.label('最后更新: 尚未更新').classes('text-sm text-gray-400 mt-2')defanalyze_text(e):"""分析文本并更新所有指标""" text = e.args if e.args else''# 计算各项指标 chars = len(text) words = len(text.split()) if text.strip() else0 lines = text.count('\n') + 1if text else0# 更新显示(这就是数据绑定的魔力!) char_count.set_text(str(chars)) word_count.set_text(str(words)) line_count.set_text(str(lines))# 更新最后分析时间 current_time = datetime.now().strftime('%H:%M:%S') update_time.set_text(f'最后更新: {current_time}')# 根据字符数改变颜色提示if chars > 200: char_count.classes(replace='text-3xl font-bold text-red-600') ui.notify('文本较长,建议分段处理!', type='warning')elif chars > 100: char_count.classes(replace='text-3xl font-bold text-yellow-600')else: char_count.classes(replace='text-3xl font-bold text-green-600')# 绑定文本变化事件text_area.on('update:model-value', analyze_text)# 添加重置按钮defreset_text(): text_area.value = '' analyze_text(type('Event', (), {'args': ''})())ui.button('清空文本', on_click=reset_text, icon='delete').classes('mt-4')ui.run(title='文本分析器', port=8081)这个例子展示了:
ui.notify() 显示提示NiceGUI提供了大量预构建组件:
# 常用组件示例ui.button('点击我', on_click=lambda: ui.notify('按钮被点击了!'))ui.checkbox('同意条款', value=True)ui.select(['选项A', '选项B', '选项C'], label='请选择')ui.slider(min=0, max=100, value=50, label='音量')ui.toggle(['白天', '黑夜'], value='白天')ui.upload(label='上传文件', on_upload=lambda e: ui.notify(f'上传了 {e.name}'))# 灵活布局示例with ui.column().classes('p-4 bg-gray-100 rounded-lg'): # 垂直列 ui.label('用户信息').classes('text-xl')with ui.row().classes('items-center gap-4'): # 水平行 ui.input('姓名').classes('flex-1') ui.input('年龄').classes('w-24')with ui.grid(columns=2).classes('gap-2 mt-2'): # 网格布局 ui.input('邮箱') ui.input('电话') ui.input('地址') ui.input('城市')import matplotlib.pyplot as pltimport numpy as np# 创建Matplotlib图表fig, ax = plt.subplots()x = np.linspace(0, 10, 100)ax.plot(x, np.sin(x), label='sin(x)')ax.plot(x, np.cos(x), label='cos(x)')ax.legend()# 在NiceGUI中显示ui.pyplot(fig)from nicegui import app# 页面1@ui.page('/')defhome(): ui.label('主页').classes('text-2xl') ui.button('去关于页面', on_click=lambda: ui.open('/about'))# 页面2@ui.page('/about')defabout(): ui.label('关于我们').classes('text-2xl') ui.button('返回主页', on_click=lambda: ui.open('/'))ui.run()我们对比一下实现同一个功能的不同方式:
<input id="myInput">JS: 获取DOM元素并绑定事件 | ui.input(label='输入') | |
input.on('update:model-value', handler) | ||
ui.button(on_click=python_function) | ||
.classes('text-red-500 font-bold') | ||
NiceGUI 的强大之处在于它极大降低了Web开发的门槛,让Python开发者能够快速将想法转化为可交互的应用。无论是快速原型、内部工具,还是中小型Web应用,NiceGUI都能提供高效的解决方案。
但更重要的是,它代表了现代开发的一种趋势:开发者应该专注于业务逻辑,而不是重复的样板代码。NiceGUI处理了所有前端复杂性的“脏活”,让你回归到解决问题的本质。
Tips: NiceGUI官网: https://nicegui.io/ 有大量示例代码
你在什么场景下最需要这样的工具?是数据分析展示、内部管理系统,还是其他什么需求?欢迎在评论区分享你的想法和使用场景!
如果你觉得这篇文章有帮助,欢迎点赞、分享,让更多Python开发者知道这个效率神器!

长按👇关注- 数据STUDIO -设为星标,干货速递
