前言

在网上搜索 “python 做界面” ，得到的结果无非是 Tkinter 、 wxWidgets 、 Qt 、 Gtk 。它们要不然就是打包后太大，要不就是界面丑，要不就是代码繁琐。这些都是 GUI，那么 web 界面又如何？

我之前推荐过 streamlit，在简单的场景下，它仍然值得推荐。但是 streamlit 实在不灵活，受限于它的核心机制，有些需求几乎无法实现。用来做简单的数据看板，还行。

streamlit 中加个边框线都很复杂，无语

我需要一个灵活的web框架，可以做web服务的网站，也可以打包成独立的 exe 。现在找到了，就是 niecgui。

看看演示效果

后续我会发布更多关于 nicegui 的教程。其中涉及重要知识点的，会以文章形式发布(方便查找)。视频主要演示实战过程。

今天，我将用一个小例子，整体体验一下 nicegui 吸引我的特性：

1. 上手 nicegui 最关键的知识点
2. 打包独立的 exe

我们需要安装这些库

pip install nicegui pyinstaller pandas openpyxl

不要忘记一键三连。你的点赞、收藏、关注，是我创作的动力。

---

启动

创建 main.py 文件。简单显示一段文本作为开始。

• 行3: 所有的组件使用 ui.xxxx 创建
• 行6: 最后必需写这句，启动服务

我们只需要简单执行 main.py 脚本即可。默认情况下，你的浏览器会自动打开了页面。效果是这样子：

注意几点：

执行脚本的控制台，此时处于占用状态。因为 nicegui 启动了一个 web 服务。

如果你关掉了这个控制台，那么服务就停止。

nicegui 使用的是 fastapi 作为 web 服务框架

此外，它会自动监控当前目录的 python 文件变化。因此我们可以直接修改代码(保存文件)，浏览器的界面会自动更新。

nicegui 内置了许多组件可以使用，我们也没必要每个组件去学习，需要的时候查文档即可。

更多组件的使用技巧，可以查看我的后续视频教程

今天重点是讲解 nicegui 的关键知识点，我将用一个非常简单的需求。看代码更直接：

界面是这样子：

’ fill=‘%23FFFFFF’%3E%3Crect x=‘249’ y=‘126’ width=‘1’ height=‘1’%3E%3C/rect%3E%3C/g%3E%3C/g%3E%3C/svg%3E)

• 需求是，在输入框中输入execl 文件，点击按钮，下方显示表格数据

---

布局

代码与界面对比，我们可以看到 nicegui 的基本布局方式：

• 按代码执行创建组件的顺序，界面上从上往下放置

很容易想到，它必定提供了一个能让我们把组件横向放置的组件，比如 ui.row:布局并非学习 nicegui 的核心知识点，现在，我们不需要关注布局

---

事件驱动

nicegui 与市面上大多数界面框架一样，使用事件驱动流程推进。在我们的需求中，点击按钮后，需要加载表格。因此需要定义按钮的点击事件。

’ fill=‘%23FFFFFF’%3E%3Crect x=‘249’ y=‘126’ width=‘1’ height=‘1’%3E%3C/rect%3E%3C/g%3E%3C/g%3E%3C/svg%3E)

• 行10-12：定义函数
• 行14：设置按钮参数 on_click = 自定义函数
• 此时点击按钮，自定义函数就会执行

但是，我们该怎么在自定义函数中加入表格？所有基于事件驱动的框架，都需要把组件提前放置好，就算当前没有合适的数据。

在 nicegui 中有三种官方的方式。建议大家耐心看完，我相信官方文档都没有讲解得这么有逻辑。

我知道官方的方式都显得挺繁琐。放心，不是只能用官方的方式，我们可以自己打造更新方式。比如像 streamlit 一样的"傻瓜模式"

方式一：直接放入空表格，在点击按钮的时候，重新填入表格数据

• 行19：在 row 组件下方创建 table 组件，这次我们需要在点击事件中使用表格对象，因此定义变量 table
• 行11：使用 pandas 加载数据
• 行13-14：改写表格的配置。nicegui 使用 aggrid，这是一个非常厉害的前端表格库，可以配置出功能强大的表格。这里我们只是配置表头和数据
• 行15：调用 update 函数，此时界面的表格才能刷新

界面是这样子的：

这种方式需要一开始定义一个空表格，显得不自然

---

方式二：使用容器

我们可以先定义一个 row 容器作为表格的占位：

• 行19：定义 row，用变量"拿着" 对象
• 行13：清除容器
• 行14：把表格移到容器里面

这种方式也显得不自然，因为表格的设置(行13-14) 与表格定义的地方(行19) 被划到不同的地方。每次都需要清除容器，比较麻烦。

---

方式三：定义刷新函数

官方为了解决上述方式的不协调，特意打造了一种刷新装饰器。其实本质上就是方式二的封装：

’ fill=‘%23FFFFFF’%3E%3Crect x=‘249’ y=‘126’ width=‘1’ height=‘1’%3E%3C/rect%3E%3C/g%3E%3C/g%3E%3C/svg%3E)

• 行20-23：定义函数，并打上 ui.refreshable 装饰器
• 行25：执行函数，相当于方式二中使用容器占位
• 行12：由于目前的版本，refreshable 不能支持参数，我们只能定义全局变量
• 行15：调用 table box.refresh 函数，相当于方式二中的，把容器内容清空，然后重新执行一次 table box 函数

实话说，这里官方设计不怎么样。这种方式由于全局变量的影响，导致代码更离散。

我已经向官方提了 issue ，未来的版本可能会得到改善

是不是感觉与 streamlit 相比，要麻烦很多？确实是这样子。不过，我们可以利用它的特性，打造出类似 streamlit 的运行方式。下一节我就会详细介绍

---

打包独立应用

nicegui 特别吸引我的一点是，它可以让我们直接打包成单文件程序，可以在其他没有安装 python 的电脑上运行。

首先，我们需要修改 main.py 的代码：

• 在 ui.run 函数中，设置2个参数
• reload = False 是打包必需
• native = True ，程序启动时，就像普通的程序一样有独立的窗体。如果此参数为False，那么启动时就会触发浏览器打开页面

然后在同目录下创建一个 build.py 文件，代码如下：

• 这与官方文档有一些不一样。安装官方给的代码，很容易把其他的python环境给打包进来，导致最终文件非常大
• 建议大家使用 venv 创建虚拟环境进行打包

然后在同目录下创建一个 build.py 文件，代码如下：

[外链图片转存中…(img-8PdW7ayu-1689833136779)]

• 这与官方文档有一些不一样。安装官方给的代码，很容易把其他的python环境给打包进来，导致最终文件非常大
• 建议大家使用 venv 创建虚拟环境进行打包

接下来就是执行这个文件即可。成功后，同目录下会看到一个 dist 的文件夹，里面就是打包后的 exe 文件。