在 CMake 项目中静态链接 libghostty-vtGhostty 官方示例 c-vt-cmake-static 全解【免费下载链接】ghostty Ghostty is a fast, feature-rich, and cross-platform terminal emulator that uses platform-native UI and GPU acceleration.项目地址: https://gitcode.com/GitHub_Trending/gh/ghosttyGhostty 除了作为终端模拟器本体还对外提供了名为 libghostty-vt 的 C 语言虚拟终端库负责解析转义序列、维护终端状态、编码输入事件等核心能力。本仓库的example/c-vt-cmake-static示例演示了如何用 CMake 的FetchContent机制以静态库形式集成该库创建一个 80x24 的终端、向其中写入 VT 转义序列再借助 Formatter 把屏幕内容输出为纯文本。读完本文你可以完整复现该示例的构建流程理解静态链接与动态链接在目标名、链接依赖如 SIMD、C 运行时上的差异并能把同一套集成方式移植到自己的 CMake 工程中。示例定位与共享库示例的对照example/c-vt-cmake-static/README.md对该示例的定位一句话概括为Demonstrates consuming libghostty-vt as astaticlibrary from a CMake project usingFetchContent. Creates a terminal, writes VT sequences into it, and formats the screen contents as plain text.即使用FetchContent从 CMake 工程以静态库形式消费 libghostty-vt。仓库中与之并列的还有共享库版本的 example/c-vt-cmake/README.md两者业务代码完全一致唯一区别在于链接的目标名——共享库示例链接ghostty-vt而本静态示例链接ghostty-vt-static。这个目标名只差一个后缀的差异背后是 CMake 封装层对两条产物路径的差异化处理编译宏、平台链接库后文会展开。libghostty-vt 的能力边界可以从头文件 include/ghostty/vt.h 的 Doxygen 说明中得到确认它包含解析转义序列、维护终端状态样式、光标、屏幕、回滚缓冲、编码输入事件等逻辑支持回滚缓冲、行换行、resize 时重排等特性API 分组涵盖 Terminal、Render State、Formatter、Snapshot、Search、OSC/SGR Parser、Paste、Unicode 工具、Focus/Key/Mouse 编码等。需要特别注意该头文件同时声明API 尚不稳定、仍在开发中生产环境使用前需自行承担变更风险。构建与运行步骤原 README 给出的构建流程只有三步前提是本机已安装zigCMake 封装层会在配置阶段执行find_program(zig REQUIRED)Zig 必须在 PATH 中cd example/c-vt-cmake-static cmake -B build cmake --build build ./build/c_vt_cmake_static执行后程序会在标准输出打印一段纯文本约 3 行带样式的字符串被还原为无格式文本即main.c中写入终端的三行内容的 Plain 格式渲染结果。其中cmake --build build阶段实际发生的事情是顶层 CMakeLists.txt 通过add_custom_command触发zig build -Demit-lib-vt一次性产出共享库、静态库、头文件和 pkg-config 文件到zig-out/目录CMake 随后把这两个产物注册为IMPORTED目标供下游链接。也就是说CMake 只是包装器真正的编译由 Zig 构建系统完成——这也是该仓库 CMake 封装头注释明确交代的架构delegates tozig build -Demit-lib-vt。使用本地代码库代替远端拉取如果不想从远端仓库克隆整个 Ghostty例如要调试本地修改README 提供了第二条命令cmake -B build -DFETCHCONTENT_SOURCE_DIR_GHOSTTY../.. cmake --build buildFETCHCONTENT_SOURCE_DIR_NAME是FetchContent的标准覆盖机制当NAME与FetchContent_Declare声明的名称此处为ghostty不区分大小写一致时FetchContent_MakeAvailable会直接使用你指定的本地目录跳过 clone/fetch。示例中../..正是相对于example/c-vt-cmake-static的仓库根目录。顶层 CMakeLists.txt 头注释中也给出了同样的写法cmake -B build -DFETCHCONTENT_SOURCE_DIR_GHOSTTY/path/to/ghostty两者等价绝对路径更通用。解读示例工程的 CMakeLists.txt示例的 example/c-vt-cmake-static/CMakeLists.txt 全文仅 13 行但每一行都值得拆解cmake_minimum_required(VERSION 3.19) project(c-vt-cmake LANGUAGES C) include(FetchContent) FetchContent_Declare(ghostty GIT_REPOSITORY https://github.com/ghostty-org/ghostty.git GIT_TAG main ) set(GHOSTTY_ZIG_BUILD_FLAGS -Dsimdfalse CACHE STRING FORCE) FetchContent_MakeAvailable(ghostty) add_executable(c_vt_cmake_static src/main.c) target_link_libraries(c_vt_cmake_static PRIVATE ghostty-vt-static)逐点说明FetchContent_Declare锁定GIT_TAG main每次配置阶段都会拉取 Ghostty 主分支的最新代码构建。由于 libghostty-vt API 尚未稳定跟踪 main 分支意味着 API 可能随时变动生产集成时通常应改钉具体 tag/commit。set(GHOSTTY_ZIG_BUILD_FLAGS -Dsimdfalse CACHE STRING FORCE)是本示例区别于共享库示例的关键一行。GHOSTTY_ZIG_BUILD_FLAGS是顶层 CMake 工程定义的 cache 变量见 CMakeLists.txt原样透传给zig build。-Dsimdfalse会关闭 SIMD 路径从而移除全部 C 运行时依赖highway、simdutf 以及 C 标准库。为什么静态示例要这么做答案在顶层 CMakeLists.txt 对静态目标的注释中On Linux and macOS, the static library is a fat archive that bundles the vendored SIMD dependencies (highway, simdutf). Consumers only need to link libc. On Windows, the SIMD dependencies are not bundled and must be linked separately. Building with-Dsimdfalseremoves all runtime dependencies.从源码结构看在 Linux/macOS 上libghostty-vt.a是一个把 SIMD 依赖打进去的 fat archive消费方只需链接libc但在Windows 上 SIMD 依赖不被打包消费方必须自行补链。示例选择在配置期强制-Dsimdfalse可以跨平台统一做到零额外运行时依赖代价是放弃 SIMD 加速。若你只在 Linux/macOS 使用静态库且希望保留 SIMD删掉这一行即可此时仍需确认 highway/simdutf 已随 fat archive 打包。FetchContent_MakeAvailable(ghostty)会执行被拉取工程的顶层CMakeLists.txt从而得到两个 IMPORTED 全局目标ghostty-vt共享与ghostty-vt-static静态。target_link_libraries(... PRIVATE ghostty-vt-static)把静态目标接给可执行文件。链接ghostty-vt-static时会自动获得两样接口属性头文件搜索路径指向zig-out/include以及编译宏GHOSTTY_STATIC见下文。PRIVATE在此处意味着不向依赖本库的其他目标导出接口由于这是最终可执行文件用PRIVATE是标准写法。静态目标的接口属性GHOSTTY_STATIC 宏与 Windows 链接库顶层 CMakeLists.txt 对ghostty-vt-static目标设置了三个关键属性add_library(ghostty-vt-static STATIC IMPORTED GLOBAL) set_target_properties(ghostty-vt-static PROPERTIES IMPORTED_LOCATION ${GHOSTTY_VT_STATIC_LIBRARY} # Linux/macOS: zig-out/lib/libghostty-vt.a INTERFACE_INCLUDE_DIRECTORIES ${ZIG_OUT_DIR}/include INTERFACE_COMPILE_DEFINITIONS GHOSTTY_STATIC ) if(WIN32) set_target_properties(ghostty-vt-static PROPERTIES INTERFACE_LINK_LIBRARIES ntdll;kernel32 ) endif()GHOSTTY_STATIC编译宏INTERFACE_COMPILE_DEFINITIONS会自动注入到每个链接该目标的编译单元中。从源码结构看它是 C ABI 头文件中用于区分静态/动态消费场景的条件编译开关例如导出符号的可见性修饰消费方不需要手动定义链接即生效。Windows 专属的ntdll;kernel32注释解释了原因——Windows 上 Zig 标准库使用了 NT API 函数NtClose、NtCreateSection等和 kernel32 函数静态链接时这些系统库必须由消费方补齐而共享库示例不需要这一步因为 DLL 自身已声明这些依赖。静态产物命名Linux/macOS 上是libghostty-vt.aWindows 上特意命名为ghostty-vt-static.lib以避开与 DLL 导入库ghostty-vt.lib的同名冲突CMakeLists.txt 注释。此外构建类型的映射也值得注意CMake 的CMAKE_BUILD_TYPE为Release/MinSizeRel/RelWithDebInfo时封装层会自动追加-DoptimizeReleaseFast传给zig buildCMakeLists.txt未指定 build type 时不加优化参数走 Debug 语义。示例程序 main.c 全流程拆解example/c-vt-cmake-static/src/main.c 完整展示了 libghostty-vt 最核心的写入—格式化调用链#include ghostty/vt.h int main() { // 1. 创建 80x24 终端 GhosttyTerminal terminal; GhosttyResult result ghostty_terminal_new(NULL, terminal, 80, 24); assert(result GHOSTTY_SUCCESS); // 2. 写入 VT 转义序列粗体/下划线/前景色 CRLF const char *commands[] { Hello from a \033[1mCMake\033[0m-built program (static)!\r\n, Line 2: \033[4munderlined\033[0m text\r\n, Line 3: \033[31mred\033[0m \033[32mgreen\033[0m \033[34mblue\033[0m\r\n, }; for (size_t i 0; i sizeof(commands) / sizeof(commands[0]); i) { ghostty_terminal_vt_write(terminal, (const uint8_t *)commands[i], strlen(commands[i])); } // 3. 创建 Formatter输出纯文本、自动裁剪行尾 GhosttyFormatterTerminalOptions fmt_opts GHOSTTY_INIT_SIZED(GhosttyFormatterTerminalOptions); fmt_opts.emit GHOSTTY_FORMATTER_FORMAT_PLAIN; fmt_opts.trim true; GhosttyFormatter formatter; result ghostty_formatter_terminal_new(NULL, formatter, terminal, fmt_opts); assert(result GHOSTTY_SUCCESS); // 4. 分配缓冲区并格式化整块屏幕 uint8_t *buf NULL; size_t len 0; result ghostty_formatter_format_alloc(formatter, NULL, buf, len); assert(result GHOSTTY_SUCCESS); printf(Plain text (%zu bytes):\n, len); fwrite(buf, 1, len, stdout); printf(\n); // 5. 按创建顺序释放 ghostty_free(NULL, buf, len); ghostty_formatter_free(formatter); ghostty_terminal_free(terminal); return 0; }各环节的要点ghostty_terminal_new(NULL, terminal, 80, 24)第一个参数是 allocator传NULL使用默认分配器后两个参数是列宽、行高。这对应 include/ghostty/vt.h 中 Terminal 与 Memory Management 两组的 API。ghostty_terminal_vt_write把字节流这里是含 CSI 序列\033[1m、\033[4m、\033[31m等的文本送入解析器。写入后终端内部即完成了转义序列解析与屏幕状态更新——这正是静态库内嵌一个完整 VT 引擎的含义无需 pty、无需真实终端环境。GHOSTTY_INIT_SIZED(...)与fmt_opts.emit GHOSTTY_FORMATTER_FORMAT_PLAINFormatter 支持把屏幕内容输出为纯文本、VT 序列或 HTML见头文件第 33 行的分组说明此处选择 Plaintrim true裁掉行尾空白。内存约定ghostty_formatter_format_alloc分配的缓冲区必须用对应的ghostty_free释放不能直接free()随后按后进先出依次释放 formatter 与 terminal。这种分配函数 配套释放函数的配对是 libghostty-vt 内存管理组的通用约定。该示例与 example/c-vt-formatter/README.md 的 Formatter 示例在 API 层面同源但本示例额外验证了从 CMake 静态链接进来的库在 C 侧行为一致这一集成命题。另一条集成路线find_package 与交叉编译FetchContent 只适合构建时集成。顶层 CMakeLists.txt 头注释还给出了第二条路线安装到 prefix 后用find_package(ghostty-vt REQUIRED)消费命名空间目标find_package(ghostty-vt REQUIRED) target_link_libraries(myapp PRIVATE ghostty-vt::ghostty-vt) # shared target_link_libraries(myapp PRIVATE ghostty-vt::ghostty-vt-static) # static该路线的配置文件由 dist/cmake/ghostty-vt-config.cmake.in 生成install时会写入prefix/lib/cmake/ghostty-vt/。其中关于静态目标的注释与 CMake 封装侧的表述略有差异config 文件写明消费方需自行链接传递依赖——libc、libcLinux 上为 libstdc、highway、simdutf使用-Dsimdfalse构建可移除 C / highway / simdutf 依赖。这与本示例选择-Dsimdfalse的做法相互印证静态集成时最省心的依赖面配置就是关闭 SIMD。若需要为非本机目标构建静态库交叉编译封装层提供了ghostty_vt_add_target()函数CMakeLists.txt它会自动处理 zig 发现、build type 到优化级别的映射、输出路径约定并生成ghostty-vt-static-NAME/ghostty-vt-NAME两个目标FetchContent_MakeAvailable(ghostty) ghostty_vt_add_target(NAME linux-amd64 ZIG_TARGET x86_64-linux-gnu ZIG_FLAGS -Dsimdfalse) target_link_libraries(myapp PRIVATE ghostty-vt-static-linux-amd64) # static target_link_libraries(myapp PRIVATE ghostty-vt-linux-amd64) # shared该仓库另有 example/c-vt-cmake-cross/README.md 专门演示交叉编译场景可作为本文 FetchContent 方式的进阶参考。小结适用前提与集成决策把本示例的结论压缩成一份可执行的集成决策表决策点说明依据构建前提构建机 PATH 中必须存在zig且版本满足 Ghostty 官方构建文档的要求CMakeLists.txt 中find_program(zig REQUIRED)实际路径为 CMakeLists.txt#L94静态 vs 共享静态链接ghostty-vt-static共享链接ghostty-vt静态目标自动带GHOSTTY_STATIC宏顶层 CMakeLists.txt 静态/共享目标定义平台依赖Linux/macOS 静态库已打包 SIMD 依赖仅需 libcWindows 需补链ntdll;kernel32SIMD 依赖不打包顶层 CMakeLists.txt 注释依赖面收敛追加GHOSTTY_ZIG_BUILD_FLAGS-Dsimdfalse可移除全部 C/SIMD 运行时依赖代价是性能路径回退标量实现本示例 CMakeLists.txt 与 config 模板注释版本锁定示例用GIT_TAG main跟踪主分支API 未稳定生产集成应钉住具体版本本地调试用FETCHCONTENT_SOURCE_DIR_GHOSTTY覆盖example/c-vt-cmake-static/README.md需要再次强调的两个适用前提其一libghostty-vt 当前处于work-in-progress状态头文件明确提示API 不稳定预期会有破坏性变更其二CMake 封装层本身只是一个转发器所有编译工作都委托给zig build -Demit-lib-vt因此集成方必须同时维护好 Zig 工具链。满足这两点的前提下example/c-vt-cmake-static提供的 13 行 CMake 与 47 行 C 代码就是一个可直接复制到自有工程的最小可运行骨架。【免费下载链接】ghostty Ghostty is a fast, feature-rich, and cross-platform terminal emulator that uses platform-native UI and GPU acceleration.项目地址: https://gitcode.com/GitHub_Trending/gh/ghostty创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
在 CMake 项目中静态链接 libghostty-vtGhostty 官方示例 c-vt-cmake-static 全解【免费下载链接】ghostty Ghostty is a fast, feature-rich, and cross-platform terminal emulator that uses platform-native UI and GPU acceleration.项目地址: https://gitcode.com/GitHub_Trending/gh/ghosttyGhostty 除了作为终端模拟器本体还对外提供了名为 libghostty-vt 的 C 语言虚拟终端库负责解析转义序列、维护终端状态、编码输入事件等核心能力。本仓库的example/c-vt-cmake-static示例演示了如何用 CMake 的FetchContent机制以静态库形式集成该库创建一个 80x24 的终端、向其中写入 VT 转义序列再借助 Formatter 把屏幕内容输出为纯文本。读完本文你可以完整复现该示例的构建流程理解静态链接与动态链接在目标名、链接依赖如 SIMD、C 运行时上的差异并能把同一套集成方式移植到自己的 CMake 工程中。示例定位与共享库示例的对照example/c-vt-cmake-static/README.md对该示例的定位一句话概括为Demonstrates consuming libghostty-vt as astaticlibrary from a CMake project usingFetchContent. Creates a terminal, writes VT sequences into it, and formats the screen contents as plain text.即使用FetchContent从 CMake 工程以静态库形式消费 libghostty-vt。仓库中与之并列的还有共享库版本的 example/c-vt-cmake/README.md两者业务代码完全一致唯一区别在于链接的目标名——共享库示例链接ghostty-vt而本静态示例链接ghostty-vt-static。这个目标名只差一个后缀的差异背后是 CMake 封装层对两条产物路径的差异化处理编译宏、平台链接库后文会展开。libghostty-vt 的能力边界可以从头文件 include/ghostty/vt.h 的 Doxygen 说明中得到确认它包含解析转义序列、维护终端状态样式、光标、屏幕、回滚缓冲、编码输入事件等逻辑支持回滚缓冲、行换行、resize 时重排等特性API 分组涵盖 Terminal、Render State、Formatter、Snapshot、Search、OSC/SGR Parser、Paste、Unicode 工具、Focus/Key/Mouse 编码等。需要特别注意该头文件同时声明API 尚不稳定、仍在开发中生产环境使用前需自行承担变更风险。构建与运行步骤原 README 给出的构建流程只有三步前提是本机已安装zigCMake 封装层会在配置阶段执行find_program(zig REQUIRED)Zig 必须在 PATH 中cd example/c-vt-cmake-static cmake -B build cmake --build build ./build/c_vt_cmake_static执行后程序会在标准输出打印一段纯文本约 3 行带样式的字符串被还原为无格式文本即main.c中写入终端的三行内容的 Plain 格式渲染结果。其中cmake --build build阶段实际发生的事情是顶层 CMakeLists.txt 通过add_custom_command触发zig build -Demit-lib-vt一次性产出共享库、静态库、头文件和 pkg-config 文件到zig-out/目录CMake 随后把这两个产物注册为IMPORTED目标供下游链接。也就是说CMake 只是包装器真正的编译由 Zig 构建系统完成——这也是该仓库 CMake 封装头注释明确交代的架构delegates tozig build -Demit-lib-vt。使用本地代码库代替远端拉取如果不想从远端仓库克隆整个 Ghostty例如要调试本地修改README 提供了第二条命令cmake -B build -DFETCHCONTENT_SOURCE_DIR_GHOSTTY../.. cmake --build buildFETCHCONTENT_SOURCE_DIR_NAME是FetchContent的标准覆盖机制当NAME与FetchContent_Declare声明的名称此处为ghostty不区分大小写一致时FetchContent_MakeAvailable会直接使用你指定的本地目录跳过 clone/fetch。示例中../..正是相对于example/c-vt-cmake-static的仓库根目录。顶层 CMakeLists.txt 头注释中也给出了同样的写法cmake -B build -DFETCHCONTENT_SOURCE_DIR_GHOSTTY/path/to/ghostty两者等价绝对路径更通用。解读示例工程的 CMakeLists.txt示例的 example/c-vt-cmake-static/CMakeLists.txt 全文仅 13 行但每一行都值得拆解cmake_minimum_required(VERSION 3.19) project(c-vt-cmake LANGUAGES C) include(FetchContent) FetchContent_Declare(ghostty GIT_REPOSITORY https://github.com/ghostty-org/ghostty.git GIT_TAG main ) set(GHOSTTY_ZIG_BUILD_FLAGS -Dsimdfalse CACHE STRING FORCE) FetchContent_MakeAvailable(ghostty) add_executable(c_vt_cmake_static src/main.c) target_link_libraries(c_vt_cmake_static PRIVATE ghostty-vt-static)逐点说明FetchContent_Declare锁定GIT_TAG main每次配置阶段都会拉取 Ghostty 主分支的最新代码构建。由于 libghostty-vt API 尚未稳定跟踪 main 分支意味着 API 可能随时变动生产集成时通常应改钉具体 tag/commit。set(GHOSTTY_ZIG_BUILD_FLAGS -Dsimdfalse CACHE STRING FORCE)是本示例区别于共享库示例的关键一行。GHOSTTY_ZIG_BUILD_FLAGS是顶层 CMake 工程定义的 cache 变量见 CMakeLists.txt原样透传给zig build。-Dsimdfalse会关闭 SIMD 路径从而移除全部 C 运行时依赖highway、simdutf 以及 C 标准库。为什么静态示例要这么做答案在顶层 CMakeLists.txt 对静态目标的注释中On Linux and macOS, the static library is a fat archive that bundles the vendored SIMD dependencies (highway, simdutf). Consumers only need to link libc. On Windows, the SIMD dependencies are not bundled and must be linked separately. Building with-Dsimdfalseremoves all runtime dependencies.从源码结构看在 Linux/macOS 上libghostty-vt.a是一个把 SIMD 依赖打进去的 fat archive消费方只需链接libc但在Windows 上 SIMD 依赖不被打包消费方必须自行补链。示例选择在配置期强制-Dsimdfalse可以跨平台统一做到零额外运行时依赖代价是放弃 SIMD 加速。若你只在 Linux/macOS 使用静态库且希望保留 SIMD删掉这一行即可此时仍需确认 highway/simdutf 已随 fat archive 打包。FetchContent_MakeAvailable(ghostty)会执行被拉取工程的顶层CMakeLists.txt从而得到两个 IMPORTED 全局目标ghostty-vt共享与ghostty-vt-static静态。target_link_libraries(... PRIVATE ghostty-vt-static)把静态目标接给可执行文件。链接ghostty-vt-static时会自动获得两样接口属性头文件搜索路径指向zig-out/include以及编译宏GHOSTTY_STATIC见下文。PRIVATE在此处意味着不向依赖本库的其他目标导出接口由于这是最终可执行文件用PRIVATE是标准写法。静态目标的接口属性GHOSTTY_STATIC 宏与 Windows 链接库顶层 CMakeLists.txt 对ghostty-vt-static目标设置了三个关键属性add_library(ghostty-vt-static STATIC IMPORTED GLOBAL) set_target_properties(ghostty-vt-static PROPERTIES IMPORTED_LOCATION ${GHOSTTY_VT_STATIC_LIBRARY} # Linux/macOS: zig-out/lib/libghostty-vt.a INTERFACE_INCLUDE_DIRECTORIES ${ZIG_OUT_DIR}/include INTERFACE_COMPILE_DEFINITIONS GHOSTTY_STATIC ) if(WIN32) set_target_properties(ghostty-vt-static PROPERTIES INTERFACE_LINK_LIBRARIES ntdll;kernel32 ) endif()GHOSTTY_STATIC编译宏INTERFACE_COMPILE_DEFINITIONS会自动注入到每个链接该目标的编译单元中。从源码结构看它是 C ABI 头文件中用于区分静态/动态消费场景的条件编译开关例如导出符号的可见性修饰消费方不需要手动定义链接即生效。Windows 专属的ntdll;kernel32注释解释了原因——Windows 上 Zig 标准库使用了 NT API 函数NtClose、NtCreateSection等和 kernel32 函数静态链接时这些系统库必须由消费方补齐而共享库示例不需要这一步因为 DLL 自身已声明这些依赖。静态产物命名Linux/macOS 上是libghostty-vt.aWindows 上特意命名为ghostty-vt-static.lib以避开与 DLL 导入库ghostty-vt.lib的同名冲突CMakeLists.txt 注释。此外构建类型的映射也值得注意CMake 的CMAKE_BUILD_TYPE为Release/MinSizeRel/RelWithDebInfo时封装层会自动追加-DoptimizeReleaseFast传给zig buildCMakeLists.txt未指定 build type 时不加优化参数走 Debug 语义。示例程序 main.c 全流程拆解example/c-vt-cmake-static/src/main.c 完整展示了 libghostty-vt 最核心的写入—格式化调用链#include ghostty/vt.h int main() { // 1. 创建 80x24 终端 GhosttyTerminal terminal; GhosttyResult result ghostty_terminal_new(NULL, terminal, 80, 24); assert(result GHOSTTY_SUCCESS); // 2. 写入 VT 转义序列粗体/下划线/前景色 CRLF const char *commands[] { Hello from a \033[1mCMake\033[0m-built program (static)!\r\n, Line 2: \033[4munderlined\033[0m text\r\n, Line 3: \033[31mred\033[0m \033[32mgreen\033[0m \033[34mblue\033[0m\r\n, }; for (size_t i 0; i sizeof(commands) / sizeof(commands[0]); i) { ghostty_terminal_vt_write(terminal, (const uint8_t *)commands[i], strlen(commands[i])); } // 3. 创建 Formatter输出纯文本、自动裁剪行尾 GhosttyFormatterTerminalOptions fmt_opts GHOSTTY_INIT_SIZED(GhosttyFormatterTerminalOptions); fmt_opts.emit GHOSTTY_FORMATTER_FORMAT_PLAIN; fmt_opts.trim true; GhosttyFormatter formatter; result ghostty_formatter_terminal_new(NULL, formatter, terminal, fmt_opts); assert(result GHOSTTY_SUCCESS); // 4. 分配缓冲区并格式化整块屏幕 uint8_t *buf NULL; size_t len 0; result ghostty_formatter_format_alloc(formatter, NULL, buf, len); assert(result GHOSTTY_SUCCESS); printf(Plain text (%zu bytes):\n, len); fwrite(buf, 1, len, stdout); printf(\n); // 5. 按创建顺序释放 ghostty_free(NULL, buf, len); ghostty_formatter_free(formatter); ghostty_terminal_free(terminal); return 0; }各环节的要点ghostty_terminal_new(NULL, terminal, 80, 24)第一个参数是 allocator传NULL使用默认分配器后两个参数是列宽、行高。这对应 include/ghostty/vt.h 中 Terminal 与 Memory Management 两组的 API。ghostty_terminal_vt_write把字节流这里是含 CSI 序列\033[1m、\033[4m、\033[31m等的文本送入解析器。写入后终端内部即完成了转义序列解析与屏幕状态更新——这正是静态库内嵌一个完整 VT 引擎的含义无需 pty、无需真实终端环境。GHOSTTY_INIT_SIZED(...)与fmt_opts.emit GHOSTTY_FORMATTER_FORMAT_PLAINFormatter 支持把屏幕内容输出为纯文本、VT 序列或 HTML见头文件第 33 行的分组说明此处选择 Plaintrim true裁掉行尾空白。内存约定ghostty_formatter_format_alloc分配的缓冲区必须用对应的ghostty_free释放不能直接free()随后按后进先出依次释放 formatter 与 terminal。这种分配函数 配套释放函数的配对是 libghostty-vt 内存管理组的通用约定。该示例与 example/c-vt-formatter/README.md 的 Formatter 示例在 API 层面同源但本示例额外验证了从 CMake 静态链接进来的库在 C 侧行为一致这一集成命题。另一条集成路线find_package 与交叉编译FetchContent 只适合构建时集成。顶层 CMakeLists.txt 头注释还给出了第二条路线安装到 prefix 后用find_package(ghostty-vt REQUIRED)消费命名空间目标find_package(ghostty-vt REQUIRED) target_link_libraries(myapp PRIVATE ghostty-vt::ghostty-vt) # shared target_link_libraries(myapp PRIVATE ghostty-vt::ghostty-vt-static) # static该路线的配置文件由 dist/cmake/ghostty-vt-config.cmake.in 生成install时会写入prefix/lib/cmake/ghostty-vt/。其中关于静态目标的注释与 CMake 封装侧的表述略有差异config 文件写明消费方需自行链接传递依赖——libc、libcLinux 上为 libstdc、highway、simdutf使用-Dsimdfalse构建可移除 C / highway / simdutf 依赖。这与本示例选择-Dsimdfalse的做法相互印证静态集成时最省心的依赖面配置就是关闭 SIMD。若需要为非本机目标构建静态库交叉编译封装层提供了ghostty_vt_add_target()函数CMakeLists.txt它会自动处理 zig 发现、build type 到优化级别的映射、输出路径约定并生成ghostty-vt-static-NAME/ghostty-vt-NAME两个目标FetchContent_MakeAvailable(ghostty) ghostty_vt_add_target(NAME linux-amd64 ZIG_TARGET x86_64-linux-gnu ZIG_FLAGS -Dsimdfalse) target_link_libraries(myapp PRIVATE ghostty-vt-static-linux-amd64) # static target_link_libraries(myapp PRIVATE ghostty-vt-linux-amd64) # shared该仓库另有 example/c-vt-cmake-cross/README.md 专门演示交叉编译场景可作为本文 FetchContent 方式的进阶参考。小结适用前提与集成决策把本示例的结论压缩成一份可执行的集成决策表决策点说明依据构建前提构建机 PATH 中必须存在zig且版本满足 Ghostty 官方构建文档的要求CMakeLists.txt 中find_program(zig REQUIRED)实际路径为 CMakeLists.txt#L94静态 vs 共享静态链接ghostty-vt-static共享链接ghostty-vt静态目标自动带GHOSTTY_STATIC宏顶层 CMakeLists.txt 静态/共享目标定义平台依赖Linux/macOS 静态库已打包 SIMD 依赖仅需 libcWindows 需补链ntdll;kernel32SIMD 依赖不打包顶层 CMakeLists.txt 注释依赖面收敛追加GHOSTTY_ZIG_BUILD_FLAGS-Dsimdfalse可移除全部 C/SIMD 运行时依赖代价是性能路径回退标量实现本示例 CMakeLists.txt 与 config 模板注释版本锁定示例用GIT_TAG main跟踪主分支API 未稳定生产集成应钉住具体版本本地调试用FETCHCONTENT_SOURCE_DIR_GHOSTTY覆盖example/c-vt-cmake-static/README.md需要再次强调的两个适用前提其一libghostty-vt 当前处于work-in-progress状态头文件明确提示API 不稳定预期会有破坏性变更其二CMake 封装层本身只是一个转发器所有编译工作都委托给zig build -Demit-lib-vt因此集成方必须同时维护好 Zig 工具链。满足这两点的前提下example/c-vt-cmake-static提供的 13 行 CMake 与 47 行 C 代码就是一个可直接复制到自有工程的最小可运行骨架。【免费下载链接】ghostty Ghostty is a fast, feature-rich, and cross-platform terminal emulator that uses platform-native UI and GPU acceleration.项目地址: https://gitcode.com/GitHub_Trending/gh/ghostty创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
