如何在 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 库。
为什么是 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
这可能涉及以下常见问题。

