
PyWebView 是一个轻量级的跨平台 Python 库,它的核心思路很直接:在桌面应用中嵌入系统原生的 WebView 组件。这意味着你可以用 HTML、CSS 和 JavaScript 来构建界面,同时让 Python 处理业务逻辑——非常适合'Web 技术做 UI + Python 做后端'的场景。
核心定位
PyWebView 并不是 Electron 那种打包 Chromium 的替代品,它更倾向于复用系统自带的 WebView(比如 Windows 的 Edge/IE、macOS 的 WebKit、Linux 的 GTK+Webkit 或 Qt WebEngine)。这样做的好处很明显:
- 体积极小:不需要额外捆绑浏览器依赖;
- 原生外观:窗口样式与系统应用保持一致;
- 性能更优:无需加载完整的 Chromium 内核。
关键特性
跨平台支持
它覆盖了主流的桌面系统,对嵌入式 Linux 也很友好(前提是具备 X11 或 Wayland 图形环境):
- Windows:默认使用 Edge (WebView2),同时也兼容 IE11(可选);
- macOS:调用系统 WebKit(Safari 内核);
- Linux:默认使用 GTK+3 + WebKit2GTK,也可以选 Qt WebEngine(需安装 PyQt5/PySide2)。
双向通信能力
这是 PyWebView 最核心的价值之一——让 Web UI 和 Python 后端无缝交互:
- Python 暴露 API 给 JS:通过
js_api参数传递 Python 对象或类,JS 端可以通过window.pywebview.api调用; - Python 调用 JS:使用
window.evaluate_js()执行 JS 代码并获取返回值; - JS 回调 Python:支持异步调用(如
async/await),适合处理复杂的交互场景。
轻量与原生体验
不捆绑浏览器意味着启动速度快,窗口标题栏、边框、图标都遵循系统规范,还能支持菜单、拖放、打印等系统级特性。
现代 Web 支持
兼容 HTML5、CSS3 和 ES6+,你可以集成 Vue、React 或 Angular 等前端框架,或者使用 QML 风格的 Web 组件。
实战示例
基础用法:加载网页
最简单的用法就是创建一个窗口,加载远程 URL 或本地 HTML 文件。
import webview
# 创建窗口,加载远程 URL 或本地 HTML 文件(file:// 开头)
window = webview.create_window(
title='PyWebView Demo',
url='https://pywebview.flowrl.com/', # 远程网页
# url='file:///path/to/local.html', # 本地 HTML
width=800,
height=,
resizable=
)
webview.start()


