BlackHalo logo
Published on

Libghostty 1.0:终端模拟核心库正式稳定

Authors
  • Name
    mfiguiere
    mitchellh.com
Libghostty 标志与终端模拟示意图
头图来源: Picsum

概述

Libghostty 1.0 的到来标志着终端模拟核心组件的独立化与稳定化。该项目从 Ghostty 终端模拟器中提取,以纯 C 库的形式提供高性能、可移植的终端模拟能力。1.0 版本意味着 C ABI 正式稳定,面向下游开发者和发行版提供了可靠的兼容性承诺。

已被广泛采用

短短一年内,libghostty 已被大量项目和产品集成。JetBrains IDE(IntelliJ、PyCharm、GoLand 等)已将终端替换为 libghostty,覆盖超过 1250 万活跃用户。Neovim 已批准用 libghostty-vt 替换 libvterm,解决了长达 10 年的缩放回滚重排问题。KDE 开发者正在实验基于该库的 Konsole 替换方案;Vercel 的 Turborepo 使用它渲染 TUI 输出;devenv 用于驱动 shell;Antithesis 用它来模糊测试 TUI 程序并发现了真实 bug。

此外,Emacs 可通过 Ghostel 使用 libghostty,WASM 构建版本 ghostty-web 提供了兼容 Xterm.js 的 API。商业产品如 OrbStack 也嵌入了它。社区已涌现出 herdr、cmux 等新一代终端和 agentic 编程工具。语言绑定覆盖 Rust、Go、JavaScript、Swift、Python、.NET、Elixir、Dart、Java 等十余种,awesome-libghostty 列表收录了上百个项目。如今,通过 libghostty 使用终端的用户数量远超直接使用 Ghostty 应用本身的用户。

ABI 稳定性保障

1.0 版本严格遵循语义化版本,并提供 ABI 兼容性承诺。设计上借鉴了优秀的 C 库经验:每个对象都是不透明句柄;数百个可读写值通过少量枚举键的 getter/setter 访问,便于未来新增而不引入新符号;较新头文件链接旧库时会返回 GHOSTTY_UNSUPPORTED 而非崩溃或未定义行为;非不透明结构体携带自身大小以便追加字段,或预留填充字节;枚举在所有编译器上固定为 int 类型。

CI 强制检查 ABI 策略:Linux 上使用 libabigail 对比基线,macOS 和 WebAssembly 上使用 golden 类型清单。ELF 平台上导出符号均带版本,动态加载器会在加载时拒绝不匹配的库,而非莫名其妙地失败。

构建与打包

Libghostty 有独立的发布周期和打包工具。每个版本发布经过签名的源码 tarball 以及依赖 tarball(包含所有 Zig 包),便于发行版离线构建。构建系统生成共享库(含 SONAME)、静态库、头文件、pkg-config 及 CMake 包配置文件,并尊重 --prefix、DESTDIR、lib64。默认保留调试信息,方便发行版拆分。所有流程记载于 PACKAGING-LIBGHOSTTY.md 中。

依赖与许可

libghostty-vt 采用 MIT 许可。运行时仅需 libc(可编译为完全独立运行,无需 libc)。编译时依赖少量宽松许可库:simdutf、Google Highway(SIMD)、紧凑 Unicode 表(用于字符簇数据)、Wuffs(Kitty 图形协议图像解码)。simdutf 和 Highway 均不链接 libc++,因此无 C++ 标准库依赖。所有依赖项在机器可读清单中列出版本、SPDX 许可和哈希,便于发行版填充捆绑库元数据。发行版也可选择动态链接系统自带的 simdutf 或 Highway。

跨平台与资源占用

CI 测试的完整平台包括 Linux(glibc、musl)的 x86_64 和 aarch64,macOS/iOS 13+ 的 x86_64 和 aarch64,FreeBSD 的 x86_64 和 aarch64,Windows 的 x86_64,Android 的 aarch64、x86_64、arm,WebAssembly 的 wasm32(独立)。此外,还有编译测试但无自动测试的平台:裸机 riscv32、thumb,WASI、Windows arm64、illumos、32 位 x86。每个平台产生对应产物:Linux/FreeBSD 共享库(带有 SONAME 和版本符号)、静态库、头文件、pkg-config 与 CMake 包配置;macOS/iOS 得到 dylib 和 XCFramework;Windows 得到 DLL、PDB、导入库和静态库(GNU ABI,MSVC 通过导入库链接,CI 验证);Android 共享库支持 16KB 页面大小(Android 15+ 要求);WebAssembly 有速度优化和体积优化两种模式,完整功能版本小于 1MB。若仅需只读查看器,可通过编译选项关闭输入编码、搜索、选择和 Kitty 图形等子系统,模块体积减半。

资源方面,库不创建任何线程,仅通过可定制的分配器分配内存,计算和内存使用极低。作者在 4 核 8GB 内存的 Linux 服务器上成功运行了 10000 个活跃终端(每个终端都有 shell 产生输出),测试中因 bash 内存占用过大而不得不改用 dash,但 libghostty-vt 本身占用极小。

未来展望

1.0 是重要里程碑。现在只需约 1500 行 C 代码即可创建一个功能丰富、性能优异的终端,比 2025 年及 2026 年的大多数终端都更出色。得益于丰富的语言绑定,几乎所有主流语言都能轻易实现。库是广义的模拟器,未来将在保持稳定的同时尽可能实现更多终端协议(提供启用/禁用选项),让嵌入者有充分的选择权。每个嵌入者报告的错误都会改善整个生态,每个新功能都会快速、安全地惠及所有人。终端发展可以更快且碎片化更少。

文档、示例和下载地址:lib.ghostty.org。

原标题:Libghostty 1.0。 HN 原始发布时间:2026年11月7日星期六。当前记录为 1030 分、178 条评论。

阅读原文 · 查看 HN 讨论