Ubuntu 安装 libwebkit2gtk-4.1-0 指南
运行基于 GTK 的本地文档查看器或 Python + WebKit 浏览器外壳时,常出现以下错误:
ImportError: cannot import name 'WebKit2' from 'gi.repository'
或:
error while loading shared libraries: libwebkit2gtk-4.1.so.0: cannot open shared object file
这通常是因为系统缺少 libwebkit2gtk-4.1-0 库。它是 GNOME 生态中许多应用(如 Devhelp、Yelp)背后的网页引擎核心组件。
为什么需要 libwebkit2gtk-4.1-0?
它是让原生桌面程序显示现代网页内容的核心组件。基于 WebKit2 架构和 GTK+3 框架,提供 WebKitWebView 控件,允许在窗口中加载网页、执行 JavaScript、支持 HTTPS 等。采用多进程架构,主程序不会因网页崩溃而挂掉。
典型应用场景:
- 内嵌帮助文档浏览器(HTML 格式)
- 轻量级 Electron 替代方案
- Kiosk 模式的固定功能终端
- 需要富文本展示能力的设置面板
安装失败排查
直接执行 sudo apt install libwebkit2gtk-4.1-0 可能提示:
E: Unable to locate package libwebkit2gtk-4.1-0
常见原因如下:
未开启 universe 源
这是最常见的情况。

