最近，在實現(xiàn)「TodoList」應(yīng)用最小化到系統(tǒng)托盤的功能時，踩了幾個坑，記錄一下。

前言

這個功能其實挺常見的：用戶點擊應(yīng)用右上角的關(guān)閉按鈕，應(yīng)用不會直接退出，而是最小化到系統(tǒng)托盤，在后臺繼續(xù)運行。

這么做的好處也很直觀——不占用桌面空間，同時保持后臺運行，避免消息提醒失效。

不過真落地實現(xiàn)的時候，還是有幾個需要注意的地方，下面展開聊聊~

代碼核心實現(xiàn)

一開始讓 AI 幫忙寫，結(jié)果跑不起來。后來參考了文末補充內(nèi)容，才把功能調(diào)通。

webview_process = None  
def run_webview():  
    webview.create_window('Webview', 'https://pywebview.flowrl.com/hello')  
    webview.start()  
if __name__ == '__main__':  
    def start_webview_process():  
        global webview_process  
        webview_process = Process(target=run_webview)  
        webview_process.start()  
    def on_open(icon, item):  
        global webview_process  
        if not webview_process.is_alive():  
            start_webview_process()  
    def on_exit(icon, item):  
        icon.stop()  
    start_webview_process()  
    image = Image.open('demo.png')  
    menu = Menu(MenuItem('Open', on_open), MenuItem('Exit', on_exit))  
    icon = Icon('Pystray', image, menu=menu)  
    icon.run()  
    webview_process.terminate()

整體思路是用到了 pystray 這個庫：

• 創(chuàng)建一個系統(tǒng)托盤圖標
• 圖標支持右鍵菜單，包含“打開”和“退出”兩個選項
• 通過 icon.run() 保持應(yīng)用在后臺持續(xù)運行
• 改造原有代碼：
  • 將 create_window 提取為獨立方法，方便重復(fù)調(diào)用
  • 用全局變量 webview_process 管理子進程，點擊“打開”時判斷是否存活，避免重復(fù)啟動
• 只有調(diào)用 icon.stop()，托盤圖標才會退出，應(yīng)用才算真正關(guān)閉

注意事項

1. 單擊托盤圖標打開應(yīng)用

在 MenuItem 中設(shè)置 default=True 即可實現(xiàn)單擊托盤圖標時觸發(fā)打開操作。

這里有個小插曲：我用 DeepSeek 咨詢時，它推薦的 default_action 函數(shù)一直不生效。后來換 Gemini，給出的方案是直接加 default=True，看引用來源是 Stack Overflow 上的回答。

估計這個問題在國內(nèi)社區(qū)討論不多，導(dǎo)致 DeepSeek 的訓(xùn)練數(shù)據(jù)里沒覆蓋到。

menu = Menu(MenuItem('打開應(yīng)用', on_open, default=True), MenuItem('徹底退出', on_exit))

2. 解決重復(fù)打開應(yīng)用的問題

這個問題也是靠 Gemini 解決的。DeepSeek 給的方案偏復(fù)雜，就沒繼續(xù)折騰。

if __name__ == '__main__':  
    # 用于解決打包后的多進程問題  
    multiprocessing.freeze_support()  
  
    # 其他代碼  

重復(fù)打開的原因是子進程重新執(zhí)行了 main 塊。兩個 AI 分析的根因基本一致：

主進程啟動
    ↓
執(zhí)行 if __name__ == '__main__': 塊
    ↓
創(chuàng)建 webview_process (子進程A)
    ↓
webview_process.start() 觸發(fā)：
    ├─ 創(chuàng)建新進程
    ├─ 重新導(dǎo)入 main.py
    ├─ 子進程A執(zhí)行 if __name__ == '__main__'?
    │   └─ 是的！因為這是新進程的入口
    └─ 再次打印 "啟動任務(wù)提醒服務(wù)..." (第2次)
    ↓
主進程繼續(xù)執(zhí)行 icon.run()
    ↓
icon.run() 阻塞主進程

3. 點擊關(guān)閉按鈕時彈出提醒

這個可以通過前端自定義彈窗 + 后端監(jiān)聽關(guān)閉事件來實現(xiàn)。不過 pywebview 本身提供了默認實現(xiàn)，我就直接偷懶用了：

webview.create_window(  
    'TodoList',  
    frontend_path,  
    js_api=api,  
    width=1400,  
    height=900,  
    text_select=True,  
    resizable=True,  
    confirm_close=True  # 增加該配置項
)

另外，pywebview 的關(guān)閉彈窗支持中文化配置，但遺憾的是不支持動態(tài)切換。如果后續(xù)英文用戶不多，可能就不折騰了~

# 定義本地化字符串字典  
chinese_localization = {  
    'global.quitConfirmation': '溫馨提示：\n關(guān)閉后，程序?qū)⒆钚』较到y(tǒng)托盤以保持消息后臺提醒。\n如需徹底關(guān)閉，請在托盤右鍵退出~',  
    'global.ok': '確定',  
    'global.cancel': '取消'  
}

webview.start(bind, backend.globals.window, private_mode=False, ssl=True, debug=False, localization= chinese_localization)

知識補充

使用pywebview創(chuàng)建后臺運行的桌面應(yīng)用

pywebview是一個輕量級的Python庫，專門用于創(chuàng)建跨平臺的桌面GUI應(yīng)用。它最大的優(yōu)勢在于能夠?qū)F(xiàn)代Web技術(shù)與傳統(tǒng)桌面應(yīng)用完美結(jié)合。通過集成pystray庫，你可以輕松為應(yīng)用添加系統(tǒng)托盤功能，讓用戶即使關(guān)閉主窗口也能保持應(yīng)用在后臺運行。

快速搭建系統(tǒng)托盤應(yīng)用

讓我們從基礎(chǔ)開始，創(chuàng)建一個簡單的系統(tǒng)托盤應(yīng)用：

from PIL import Image
from pystray import Icon, Menu, MenuItem
import webview
def create_tray_icon():
    # 加載應(yīng)用圖標
    image = Image.open('logo/logo.png')
    # 創(chuàng)建托盤菜單
    menu = Menu(
        MenuItem('打開應(yīng)用', on_open),
        MenuItem('退出', on_exit)
    )
    # 創(chuàng)建系統(tǒng)托盤圖標
    icon = Icon('MyApp', image, menu=menu)
    return icon
def on_open(icon, item):
    # 顯示應(yīng)用窗口的邏輯
    pass
def on_exit(icon, item):
    # 退出應(yīng)用的邏輯
    icon.stop()

到此這篇關(guān)于Python桌面端應(yīng)用最小化托盤開發(fā)實踐指南的文章就介紹到這了,更多相關(guān)Python桌面應(yīng)用開發(fā)內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論