Python中PyWebview庫(kù)的具體使用

更新時(shí)間：2025年12月16日 08:38:21 作者：華麗的周遭

pywebview是一個(gè)輕量級(jí)、跨平臺(tái)的 Python 庫(kù),用于在桌面應(yīng)用中嵌入系統(tǒng)原生的WebView組件,下面就來詳細(xì)的介紹一下PyWebview庫(kù)的使用,感興趣的可以了解一下

pywebview是一個(gè)輕量級(jí)、跨平臺(tái)的 Python 庫(kù)，核心功能是在桌面應(yīng)用中嵌入系統(tǒng)原生的 WebView 組件，讓你可以用 HTML/CSS/JavaScript 構(gòu)建 UI，同時(shí)用 Python 處理邏輯——完美匹配“Web 技術(shù)做 UI + Python 做后端”的需求。

1. 核心定位

pywebview 不是“打包 Chromium 的 Electron 替代品”，而是復(fù)用系統(tǒng)自帶的 WebView（如 Windows 的 Edge/IE、macOS 的 WebKit、Linux 的 GTK+Webkit/Qt WebEngine），因此：

體積極?。o額外瀏覽器依賴）；
外觀與系統(tǒng)原生應(yīng)用一致；
性能更優(yōu)（無需加載完整的 Chromium）。

2. 關(guān)鍵特點(diǎn)

（1）跨平臺(tái)支持

覆蓋主流桌面系統(tǒng)，嵌入式 Linux 也友好（需 X11/Wayland 圖形環(huán)境）：

Windows：默認(rèn)用 Edge (WebView2)，兼容 IE11（可選）；
macOS：用系統(tǒng) WebKit（Safari 內(nèi)核）；
Linux：默認(rèn)用 GTK+3 + WebKit2GTK，可選 Qt WebEngine（需 PyQt5/PySide2）。

（2）雙向通信（JS ↔ Python）

最核心的能力之一——讓 Web UI 和 Python 后端無縫交互：

Python 暴露 API 給 JS：通過 js_api參數(shù)傳遞 Python 對(duì)象/類，JS 可通過 window.pywebview.api調(diào)用；
Python 調(diào)用 JS：用 window.evaluate_js()執(zhí)行 JS 代碼，獲取返回值；
JS 回調(diào) Python：支持異步調(diào)用（如 async/await），適合復(fù)雜交互。

（3）輕量與原生體驗(yàn)

不捆綁瀏覽器，啟動(dòng)速度快；
窗口樣式（標(biāo)題欄、邊框、圖標(biāo)）遵循系統(tǒng)規(guī)范；
支持系統(tǒng)級(jí)特性（如菜單、拖放、打?。?。

（4）現(xiàn)代 Web 支持

兼容 HTML5、CSS3、ES6+，可集成 Vue/React/Angular 等前端框架，或用 QML 風(fēng)格的 Web 組件。

3. 基礎(chǔ)使用示例

（1）最簡(jiǎn)示例：加載網(wǎng)頁(yè)/本地 HTML

import webview

# 創(chuàng)建窗口，加載遠(yuǎn)程 URL 或本地 HTML 文件（file:// 開頭）
window = webview.create_window(
    title='PyWebView Demo',
    url='https://pywebview.flowrl.com/',  # 遠(yuǎn)程網(wǎng)頁(yè)
    # url='file:///path/to/local.html',   # 本地 HTML
    width=800,
    height=600,
    resizable=True
)

# 啟動(dòng)應(yīng)用（阻塞式，直到窗口關(guān)閉）
webview.start()

（2）雙向通信示例

Python 端（暴露 API）：

import webview

class PythonAPI:
    def greet(self, name):
        """JS 調(diào)用的 Python 方法"""
        return f"Hello, {name}! (from Python)"

    def show_alert(self, message):
        """Python 主動(dòng)調(diào)用 JS 彈窗"""
        window.evaluate_js(f'alert("{message}")')

# 創(chuàng)建窗口時(shí)綁定 API
window = webview.create_window(
    'API Demo',
    url='index.html',  # 本地 HTML 文件
    js_api=PythonAPI()  # 暴露給 JS 的對(duì)象
)

webview.start()

JS 端（index.html）：

<!DOCTYPE html>
<html>
<body>
    <input type="text" id="name" placeholder="Enter your name">
    <button onclick="callPythonGreet()">Call Python Greet</button>
    <button onclick="callPythonAlert()">Call Python Alert</button>

    <script>
        // 調(diào)用 Python 的 greet 方法（異步）
        async function callPythonGreet() {
            const name = document.getElementById('name').value;
            const result = await window.pywebview.api.greet(name);
            alert(result);
        }

        // 調(diào)用 Python 的 show_alert 方法（同步）
        function callPythonAlert() {
            window.pywebview.api.show_alert('Hi from JS!');
        }
    </script>
</body>
</html>

4. 安裝與依賴

通用安裝：pip install pywebview
Linux 額外依賴（GTK+ 后端）：

Ubuntu/Debian：sudo apt-get install python3-gi python3-gi-cairo gir1.2-webkit2-4.0

Fedora：sudo dnf install python3-gobject gtk3 webkit2gtk3
Qt 后端（可選）：需先安裝 PyQt5/PySide2，再用 pip install pywebview[qt]

5. 適用場(chǎng)景

完美匹配的需求：

用 Web 技術(shù)快速構(gòu)建桌面 UI：比如工具類應(yīng)用（配置界面、監(jiān)控面板）、輕量級(jí)客戶端；
嵌入式 Linux GUI：在帶屏的嵌入式設(shè)備（如工業(yè)平板、智能終端）上，用 Web 做靈活 UI，Python 處理邏輯；
混合應(yīng)用開發(fā)：結(jié)合 Flask/Django 做本地服務(wù)器，pywebview 加載 http://localhost:5000作為 UI；
原型驗(yàn)證：快速將 Web 原型轉(zhuǎn)為桌面應(yīng)用，無需學(xué)習(xí) Qt/Cocoa 等原生 GUI 框架。