Ghostty 安装教程:3 分钟装好 GPU 加速终端并配置完成
【免费下载链接】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
这是一份 Ghostty 安装与上手教程,读完你能在 3 分钟内装好这个 GPU 加速、界面原生的终端模拟器,完成启动验证和最小化配置,遇到问题知道下一步去哪查。
谁适合看这篇
- 日常写命令行、想换掉卡顿终端的开发同学:标签、分屏、Kitty 图形协议都开箱即用
- 多设备开发者:macOS 与 Linux 用同一套配置习惯,换机零成本迁移
- 参与 Ghostty 开发的人:文末源码构建小节覆盖从 Git 检出到产出可执行文件的完整流程
挑一条安装路线
先按你的系统选路,再照着执行,避免装到一半发现走错方向:
| 安装方式 | 难度 | 适用场景 | 一行命令预览 |
|---|---|---|---|
| Homebrew(macOS) | ★ | 苹果设备,最省心 | brew install ghostty |
| 包管理器(Linux) | ★ | Arch / Debian 等主流发行版 | sudo pacman -S ghostty |
| Nix(跨平台) | ★★ | 已装 Nix 的机器 | nix profile install nixpkgs#ghostty |
| 源码构建 | ★★★ | 尝鲜最新特性或参与开发 | zig build -Doptimize=ReleaseFast |
快速路径:三分钟装好
macOS:Homebrew 一条命令
这条命令让 Homebrew 下载并装好 Ghostty 预编译包:
brew install ghostty跑完后ghostty进入 PATH,Dock 里也会出现应用图标,双击即可打开第一个窗口。
Linux:走发行版仓库
以 Arch 为例,这条命令直接从仓库装好 Ghostty:
sudo pacman -S ghosttyDebian / Ubuntu 用户把命令换成sudo apt install ghostty。发行版仓库里没有的话,去官网下载页拿对应平台的预编译包,跳过后面所有编译步骤。
Nix 用户:跨平台通用
这条命令把 Ghostty 装进你的 Nix profile,macOS 和 Linux 通用:
nix profile install nixpkgs#ghostty装完直接ghostty启动,Nix 会处理所有运行依赖。
进阶:源码构建四步走
适合想要最新特性或准备提交代码的人。流程固定:拿代码、装依赖、编译、找产物。
第一步:拿源码
这条命令克隆 Ghostty 仓库并进入目录:
git clone https://gitcode.com/GitHub_Trending/gh/ghostty cd ghostty跑完后当前目录就是仓库根目录,能看到build.zig.zon、HACKING.md等文件即代表成功。
第二步:装构建依赖
先装 Zig 0.16.0 及以上版本(仓库build.zig.zon里minimum_zig_version明确要求 0.16.0),Homebrew 用户执行brew install zig即可。然后按平台补依赖:
sudo apt install libgtk-3-dev blueprint-compilerArch 用户换成sudo pacman -S gtk3 blueprint-compiler。macOS 只需装全 Xcode(含 macOS SDK 与 Metal 工具链),主分支要求 Xcode 26 加 macOS 26 SDK,以仓库 HACKING.md 为准。
第三步:编译
这条命令以 ReleaseFast 优化级别编译,是正式使用的推荐参数:
zig build -Doptimize=ReleaseFast顺利跑完约需几分钟,结束时没有任何报错输出即代表构建成功。想边调试边看,去掉-Doptimize参数执行zig build得到调试构建。
第四步:找产物
Linux 下可执行文件固定在zig-out/bin/ghostty,这条命令直接启动验证:
./zig-out/bin/ghosttymacOS 下产物是zig-out目录里的应用包,双击启动或执行zig build run直接运行。
装完之后:验证成功与 5 分钟配置
验证安装
这条命令打印版本号,确认安装完整:
ghostty --version看到1.3.x的版本号输出即代表安装成功。
最小配置
首次启动若没有配置文件,Ghostty 会在默认路径自动生成:Linux 是~/.config/ghostty/config,macOS 是~/Library/Application Support/com.mitchellh.ghostty/config(默认路径定义见 src/config/file_load.zig)。最小配置只写你想改的两行,其余保持默认:
font-family = JetBrains Mono theme = catppuccin-mocha保存后按 Ctrl+Shift+,(macOS 为 Cmd+Shift+,)热重载,窗口字体和配色立即生效,不用重启。想看全部配置项和默认值:
ghostty +show-config --default --docs卡住了?先查这张表
| 现象 | 原因 | 解法 |
|---|---|---|
zig build一开始就报 Zig 版本错误 | 项目要求 Zig 0.16.0+,当前版本更低 | 升级 Zig 后重跑构建命令 |
| Linux 构建报缺 GTK 或 blueprint-compiler | 源码构建依赖没装全 | 执行sudo apt install libgtk-3-dev blueprint-compiler(Arch 为sudo pacman -S gtk3 blueprint-compiler) |
| macOS 编译报 SDK 或工具链错误 | Xcode 版本不对或未选择正确版本 | 执行sudo xcode-select --switch /Applications/Xcode.app,并确认满足 HACKING.md 里的 Xcode 26 / macOS 26 SDK 要求 |
| 启动后找不到配置文件 | 默认路径不在你以为的位置 | Linux 查~/.config/ghostty/config,macOS 查~/Library/Application Support/com.mitchellh.ghostty/config |
ghostty --version报命令不存在 | 构建产物不在 PATH 或包名拼错 | Linux 先跑./zig-out/bin/ghostty;包管理器安装则重装对应包 |
一句话收尾
到这里,你已装好 Ghostty 并完成了验证、最小配置和热重载,3 分钟流程全部跑通 🚀 更多配置项去官网文档翻,参与贡献前读一遍 CONTRIBUTING.md,翻译工作看 po/ 目录说明,社区讨论以仓库 Discussions 和官方 Discord 为主。现在就打开终端,敲下你的第一条 Ghostty 命令吧 ⚡
【免费下载链接】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),仅供参考