Ladybird 独立网页浏览器

它是什么

Ladybird 是一个有自己引擎的网页浏览器，建立在网页标准之上。它的 README 称它是一个真正独立的网页浏览器，处于 pre-alpha 阶段，只适合开发者使用。FAQ 说它不是 Chromium 的外壳，不是 WebKit 的移植，也不是 Firefox 的分支。许多核心库继承自 SerenityOS，FAQ 在第三方库里点了 Harfbuzz、Skia、simdutf 和 libcurl 的名。这个条目讲的是怎么编译和运行它，因为没有安装包可以下载。

1. 为你的系统装好编译需要的软件包
2. 克隆仓库
3. 在克隆出的文件夹里运行 ./Meta/ladybird.py run
4. 脚本编译出 Release 版本并启动它
5. 试用网站，给出问题的页面写一个精简的测试用例

适合谁

想试试一个新浏览器引擎、读它的代码，或者用它测自己网站的开发者。README 说它眼下只适合开发者。FAQ 的路线图列出了 2026 年面向 Linux 和 macOS 的 alpha 版，对象是开发者和早期尝鲜者，所以眼下是自己编译它，而不是安装它。

如果你要的是每天用的浏览器，可以不用它。README 说它只适合开发者，FAQ 说你得从源码编译才能试用。

用在哪里

README 说 Ladybird 能在 Linux、macOS、Windows（用 WSL2）和许多其他类 Unix 系统上运行。编译页面给了 Linux、macOS、Windows、FreeBSD 和 Android 的步骤。

• Linux：Debian 和 Ubuntu、Arch 和 Manjaro、Fedora、openSUSE 和 Void，每个都有自己的软件包命令；Nix 则用 nix-environments 仓库里维护的一个开发 shell
• macOS：Xcode 15，或者 Homebrew 的 clang
• Windows：WSL2 是受支持的途径，原生的 Clang-CL 编译还是实验性的
• FreeBSD：编译页面上有一行软件包命令
• Android：Android Studio，或者 UI/Android 里的 Gradle

Ladybird 会用两种前端之一来编译。Android 有自己的 Android UI，其他所有平台用 Qt。

如何设置

点“获取”会把一个装有 Mindket 安装说明的 zip 压缩包存进你的下载文件夹，里面按 Ladybird 编译页面列出了每个平台的步骤。主要途径是一个脚本 Meta/ladybird.py，前提是先装好你系统的软件包。

1. 装好你系统的软件包。这个工具包的安装说明里有编译页面给出的软件包命令。
2. 克隆仓库并进入它的文件夹。
3. 运行脚本。它会编译出 Release 版本的 Ladybird 和它的依赖，然后启动它。
4. 想要 Debug 版本，就在同一条命令前面把 BUILD_PRESET 设成 Debug。

git clone https://github.com/LadybirdBrowser/ladybird.git
cd ladybird
./Meta/ladybird.py run

BUILD_PRESET=Debug ./Meta/ladybird.py run

在 macOS 上用 Homebrew 的 clang 时，编译页面给的是这种写法：

CC=$(brew --prefix llvm)/bin/clang CXX=$(brew --prefix llvm)/bin/clang++ ./Meta/ladybird.py run

在 Windows 上编译实验性的 Clang-CL 版本，编译页面先用 Chocolatey 装好 vcpkg 需要的 pkg-config，再在 VS 命令提示符里编译：

choco install pkgconfiglite -y
py Meta\ladybird.py build

如何使用

编译完成后，run 命令会启动 Ladybird。同一个脚本还有几条别的命令。

--no-build 要放在可执行文件名前面。名字后面的内容都会传给那个可执行文件。

./Meta/ladybird.py run --no-build js --evaluate 'console.log(1 + 1)'

示例

一个页面在 Ladybird 里显示不对，在别的浏览器里正常。你把它存成 REDUCTION.html，用 Ladybird 打开这个文件，确认同样的问题还在。然后一步步删减，每删一次就重新加载。先在 Ladybird 的 Debug 菜单里取消勾选 Enable Scripting，看问题是不是脚本引起的。再一次删掉一条 CSS 规则或一个元素。

如果页面不是用 SingleFile 存下来的，ISSUES.md 说要在文档里放一个 base 元素，像下面这样，这样相对路径的图片、样式表和脚本才能加载：

<base href="https://ladybird.org/">

仍然能重现问题的最小文件，传到 CodePen、JSBin 或 JSFiddle 这样的网站上。它的网址写进 bug 报告表单。

新手与专家

新手：浏览器引擎是加载页面并把它画出来的那一部分。Ladybird 自己写了一套，没有沿用 Chromium、WebKit 或 Firefox 里的那个。把它编译出来是第一道测试。挑出你系统的那份说明，装好软件包，再运行脚本。如果编译失败，先读故障排除那份说明再去问。项目希望编译问题发到它 Discord 的 build-problems 频道，而不是 GitHub 的 issue。

专家：每个标签页跑在自己的、有沙箱的 WebContent 进程里。图片解码和网络连接在进程外运行，分别是 ImageDecoder 和 RequestServer。代码分成 LibWeb、LibJS、LibWasm 这样的库，用的是项目自己的 AK 库，不用 C++ STL。FAQ 说功能是按规范算法一步一步实现的，注释里放规范原文，对应不到任何规范步骤的代码带一个 AD-HOC: 标记。

打包，或者要编译几种不同配置的话，可以用自定义编译目录，不用那个脚本。编译页面给了下面这几行，还给了一个供内存小的机器用的链接池大小。不用这个脚本时，你可能要用 CMAKE_C_COMPILER 和 CMAKE_CXX_COMPILER 选项指定一个合适的 C++ 编译器。

cmake --preset Release -B MyBuildDir
cmake --build --preset Release MyBuildDir
ninja -C MyBuildDir run-ladybird

cmake --preset Release -B MyBuildDir -DLAGOM_LINK_POOL_SIZE=2

注意事项

这个条目讲的大部分是在你电脑上运行的编译，有几件事在这之外。

• 阶段：README 说是 pre-alpha。FAQ 路线图列出 2026 年面向 Linux 和 macOS 的 alpha、2027 年面向 Linux 和 macOS 的可下载 beta，以及 2028 年面向大众使用的稳定版
• 依赖：编译通过 vcpkg 管理它的第三方依赖，其中一个出错时，可能表现为一条 Ninja 错误
• 参与：CONTRIBUTING.md 说只有项目维护者能改代码，不接受其他人的拉取请求。欢迎 bug 报告、精简用例和网站测试
• Windows：FAQ 说原生移植不是优先事项，所以走 WSL2
• 故障排除：有一个修复要改整个系统的 /etc/ssl/openssl.cnf，用之前先读一遍
• 资金：FAQ 说项目完全靠捐款和赞助，不做默认搜索引擎交易，也不靠其他用户变现
• 不是认可：这些说明是 Mindket 写的，Ladybird 项目既没有制作也没有认可
• 许可证：BSD 2-Clause，版权由 Ladybird 开发者持有