pywebview：用Python+Web技术打造轻量级桌面应用！

优质文章学习记录

— 7 min read
pywebview：用Python+Web技术打造轻量级桌面应用！
✍️作者：唐叔在学习
💡专栏：唐叔学python
✨关键词：Python桌面开发、pywebview教程、WebView应用、前后端分离、JS与Python交互、桌面应用打包、Electron替代方案、Python GUI

大家好，我是唐叔。今天我们来聊聊一个非常轻量且强大的Python库——pywebview。如果你曾经为开发一个简单的桌面应用而纠结于Electron的笨重、PyQt的复杂，或是Tkinter的界面简陋，那pywebview或许正是你一直在找的解决方案。

文章目录

一、介绍

pywebview 是一个轻量级的跨平台Python库，它允许你在一个原生窗口中嵌入Web技术（HTML/CSS/JS）来构建GUI界面。本质上，它就是一个迷你浏览器内核，让你可以用写网页的方式写桌面应用。

与其他桌面框架对比：

  • Electron：功能强大，但打包体积大、内存占用高。
  • PyQt/Tkinter：原生控件，但界面现代化程度低、开发效率不高。
  • pywebview：轻量、跨平台、易上手，适合快速开发中小型桌面应用，尤其是已有Web前端的项目。

二、安装

安装全量版本

pip install pywebview

安装指定环境版本

如果你希望控制依赖版本，可以使用：

pip install pywebview[qt]# 使用Qt后端 pip install pywebview[cef]# 使用CEF后端

三、使用入门

3.1 基本使用

来看一个最简单的例子：

import webview defmain(): window = webview.create_window('Hello pywebview','https://pywebview.flowrl.com') webview.start()if __name__ =='__main__': main()

函数说明：

  • create_window()：创建窗口，参数包括标题和初始URL或本地HTML路径。
  • start()：启动GUI事件循环。

3.2 应用程序架构

纯网络服务架构

就如上文的基本使用，前端只需暴露应用服务器，后端调用即可

import webview if __name__ =='__main__': webview.create_window("My App","http://localhost:3000") webview.start(http_server=True, port=3000)
官网有完整的示例 基于 Flask 的应用程序 供参考学习。
无服务器架构

完全不使用网络服务器，通过 webview.create_window(...html='') 或者 window.load_html 加载 HTML。

import webview html=''' <!DOCTYPE html> <html> <body> <h1>Hello from HTML!</h1> </body> </html> ''' webview.create_window("Local App", html=html) webview.start()
根据官网说明：这种方法有一些限制，因为在加载的页面上下文中没有文件系统。图片和其他资源只能通过 Base64 内联加载。

3.3 JS与Python交互

pywebview 支持在JS中调用Python函数，也支持在Python中调用JS方法。

下述是JS中调用Python函数的代码示例：

Python端：

import webview classApi:defget_message(self):return"Hello from Python!"if __name__ =='__main__': api = Api() window = webview.create_window('JS 接口 示例','index.html', js_api=api) webview.start()

JS端（在HTML中）：

<!DOCTYPEhtml><html><body><buttononClick="greet()">打招呼</button></body><script>functiongreet(){ pywebview.api.get_message().then(function(message){alert(message);});}</script></html>
✅ 推荐将Python逻辑封装成API，JS中异步调用，保持前后端分离。

四、应用打包

使用 pyinstaller 打包你的应用：

pyinstaller --onefile --windowed your_script.py

打包后会生成一个独立的可执行文件，可在没有Python环境的机器上运行。

有关 pyinstaller 的介绍，详情请查阅唐叔的这篇文章：告别Python环境依赖！用PyInstaller打包EXE的终极指南_python打包成exe-ZEEKLOG博客

五、常见使用场景

5.1 文件操作

文件下载

你可以使用Python控制文件下载路径，或由前端触发下载。

import webview if __name__ =='__main__':# 创建一个标准的 webview 窗口 webview.settings['ALLOW_DOWNLOADS']=True window = webview.create_window('Simple browser','https://pywebview.idepy.com/download') webview.start()
文件拖放

下述是常见的文件拖放效果，实际上是通过拖放后获取到文件路径，进而通过文件路径调用相关API再进一步操作文件。

import webview from webview.dom import DOMEventHandler defon_drag(e):passdefon_drop(e): files = e['dataTransfer']['files']iflen(files)==0:returnprint(f'事件类型: {e["type"]}。被拖入的文件：')forfilein files:print(file.get('pywebviewFullPath'))defbind(window): window.dom.document.events.dragenter += DOMEventHandler(on_drag,True,True) window.dom.document.events.dragstart += DOMEventHandler(on_drag,True,True) window.dom.document.events.dragover += DOMEventHandler(on_drag,True,True, debounce=500) window.dom.document.events.drop += DOMEventHandler(on_drop,True,True)if __name__ =='__main__': window = webview.create_window('拖放示例', html=''' <html> <body-> <h1>将文件拖放到此处</h1> </body> </html> ''') webview.start(bind, window)

5.2 自定义菜单

pywebview 支持自定义系统菜单：

import webview import webview.menu as wm defchange_active_window_content(): active_window = webview.active_window()if active_window: active_window.load_html('<h1>You changed this window!</h1>')defclick_me(): active_window = webview.active_window()if active_window: active_window.load_html('<h1>You clicked me!</h1>')defdo_nothing():passdefsay_this_is_window_2(): active_window = webview.active_window()if active_window: active_window.load_html('<h1>This is window 2</h2>')defopen_file_dialog(): active_window = webview.active_window() active_window.create_file_dialog(webview.SAVE_DIALOG, directory='/', save_filename='test.file')if __name__ =='__main__': window_1 = webview.create_window('Application Menu Example','https://pywebview.idepy.com/hello') window_2 = webview.create_window('Another Window', html='<h1>Another window to test application menu</h1>') menu_items =[ wm.Menu('Test Menu',[ wm.MenuAction('Change Active Window Content', change_active_window_content), wm.MenuSeparator(), wm.Menu('Random',[ wm.MenuAction('Click Me', click_me), wm.MenuAction('File Dialog', open_file_dialog),],),],), wm.Menu('Nothing Here',[wm.MenuAction('This will do nothing', do_nothing)]),] webview.start(menu=menu_items)
💡 你也可以完全用HTML+CSS在前端构建菜单，更灵活美观。

5.3 图标设置

使用 webview.start(icon=<file_path>) 设置窗口图标。

import webview if __name__ =='__main__': window = webview.create_window('Set window icon','https://pywebview.idepy.com/hello') webview.start(icon='../logo/logo.png')
此方法仅在 GTK 和 QT 平台上受支持。其他平台的图标将在冻结过程中设置。

六、总结

pywebview 是一个非常灵活且强大的工具，尤其适合：

  • 已有Web前端，想快速封装成桌面应用；
  • 希望用HTML/CSS/JS构建现代化界面；
  • 对应用体积和内存占用有要求的场景；
  • 需要跨平台运行（Windows/macOS/Linux）。

它的学习曲线平缓，社区活跃，文档完善，是Python开发者进军桌面应用开发的绝佳选择。

如果你正在寻找一个轻量、高效、易扩展的桌面开发方案，不妨试试 pywebview，相信它会给你带来惊喜。

唐叔说：
技术选型没有绝对的好坏，只有适合与否。pywebview 在我多个中小项目中表现出色，尤其是在快速原型和内部工具开发中。希望这篇指南能帮你少走弯路，早日打造出属于自己的桌面应用！

如果有新的想法，欢迎在评论区留言，我们一起交流进步！🎉

参考资料

Read more

Neo4j-Desktop2.0安装教程(更改安装路径)

Neo4j-Desktop2.0安装教程(更改安装路径)

引言        由于neo4j-desktop2.0版本是不提供安装页面（默认安装在C盘），从而让你选择安装路径的，这对于C盘内存来说是灾难性的。因此，需要手动设置安装路径。 参考文献： 1. https://zhuanlan.zhihu.com/p/1935104156433121644https://zhuanlan.zhihu.com/p/1935104156433121644 2. https://blog.ZEEKLOG.net/WMXJY/article/details/150649084 安装包下载：https://neo4j.com/deployment-center/?desktop-gdbhttps://neo4j.com/deployment-center/?desktop-gdb 1文件夹创建及环境变量设置     首先需要在C盘以外的位置先创建一个Neo4j2文件夹，再在下面创建两个文件夹：App，PROData来存放软件本体和相关数据 然后打开“高级系统设置”——“环境变量”——系统变量下方的“新建”

开源：AI+无人机巡检系统项目调研

主流开源AI无人机巡检项目调研 本部分系统梳理了当前主流的开源无人机巡检相关项目，涵盖飞控系统、地面站软件、AI视觉识别、数据处理等多个技术栈，为商业化产品开发提供技术选型参考。 一、飞控与地面站开源项目 1.1 PX4 Autopilot 项目地址：github.com/PX4/PX4-Autopilot 开源协议：BSD 3-Clause 项目简介：由Dronecode基金会（Linux基金会旗下）维护的专业级开源自动驾驶仪软件，是全球最广泛使用的无人机飞控系统之一。支持多旋翼、固定翼、垂直起降等多种机型，广泛应用于工业无人机和科研领域。 核心能力：飞行控制、任务规划、传感器融合、MAVLink通信协议、硬件抽象层、模块化架构 1.2 ArduPilot 项目地址：github.com/ArduPilot/ardupilot 开源协议：GPLv3 项目简介：历史最悠久的开源自动驾驶仪项目，社区活跃度极高。
PyTorch实战——基于文本引导的图像生成技术与Stable Diffusion实践

PyTorch实战——基于文本引导的图像生成技术与Stable Diffusion实践

PyTorch实战——基于文本引导的图像生成技术与Stable Diffusion实践 * 0. 前言 * 1. 基于扩散模型的文本生成图像 * 2. 将文本输入编码为嵌入向量 * 3. 条件 UNet 模型中的文本数据融合机制 * 4. 使用 Stable Diffusion 模型生成图像 * 相关链接 0. 前言 在本节中，我们将为扩散模型添加文本控制能力。学习如何通过文字描述来引导图像生成过程，实现从"纯噪声+文本"生成图像，而不仅是从纯噪声生成。 1. 基于扩散模型的文本生成图像 在扩散模型的 UNet 模型训练流程中，我们仅训练模型从含噪图像中预测噪声。为实现文生图功能，需使用以下架构，将文本作为额外输入注入 UNet 模型： 这样的 UNet 模型称为条件 UNet 模型 ，或者更精确地说，是文本条件 UNet

智能桌面机器人快速上手指南：3步打造你的AI桌面伙伴

智能桌面机器人快速上手指南：3步打造你的AI桌面伙伴 【免费下载链接】ElectronBot 项目地址: https://gitcode.com/gh_mirrors/el/ElectronBot 想拥有一个能眨眼、会表达情绪的智能桌面机器人吗？ElectronBot这个开源项目让你零基础也能实现这个梦想！无论你是编程新手还是硬件爱好者，跟着这篇指南，3步就能搭建属于自己的AI桌面伙伴。 为什么你应该尝试智能桌面机器人？ 桌面机器人不只是科技玩具，它更是连接现实与数字世界的桥梁。通过ElectronBot项目，你将收获： * 动手乐趣：亲手组装机械部件，感受创造的快乐 * 编程入门：通过简单的代码控制机器人动作，轻松学习编程思维 * 创意表达：让这个小机器人成为你的表情包播放器、桌面提醒助手 三大技术突破：从想象到现实 突破一：模块化设计让搭建变简单 🎯 传统的机器人制作需要深厚的硬件知识，但ElectronBot采用模块化设计，将复杂系统分解为四个核心模块： * 主控大脑：STM32芯片负责整体协调 * 感知系统：手势识别传感器让机器人"看懂"你的动