導入したのでメモ。
設定ファイルの場所
実際に使用している設定ファイル
~/.config/ghostty/config- dotfilesで管理:
~/dotfiles/ghostty/config - シンボリックリンク:
ln -sf ~/dotfiles/ghostty ~/.config/ghostty - dotfiles/ghostty/config at main · glxy96/dotfiles
macOSのデフォルト場所(使用していない)
~/Library/Application Support/com.mitchellh.ghostty/config- Cmd+, で開かれるファイル
- 自動生成されたテンプレート(空)
- 編集しても反映されない(優先度が低いため)
設定ファイルの読み込み優先順位
Ghosttyは以下の順序で設定を読み込み、後から読み込まれた設定が上書きする:
$XDG_CONFIG_HOME/ghostty/config(環境変数設定時)~/.config/ghostty/config← これを使用中~/Library/Application Support/com.mitchellh.ghostty/config(macOS固有)
つまり:
~/.config/ghostty/configが存在する場合、これが優先される- macOS固有のパスは無視される
管理方法
現在の構成
~/dotfiles/ghostty/config # 実体
↓ (シンボリックリンク)
~/.config/ghostty/config # Ghosttyが読み込む場所設定変更の手順
# 1. dotfilesのファイルを編集
nvim ~/dotfiles/ghostty/config
# 2. Ghosttyで設定をリロード
# Cmd+Shift+, を押すCmd+, の動作
~/Library/Application Support/com.mitchellh.ghostty/configが開かれる- このファイルを編集しても反映されない
- Ghostty側の既知の問題(GitHub Discussion #5516)
なぜこうなっているのか
Ghosttyの設計思想
-
クロスプラットフォーム対応
- Linux/macOSで同じパス(
~/.config/ghostty/config)を使える - dotfilesでの管理が容易
- Linux/macOSで同じパス(
-
macOSネイティブ対応
- macOSユーザー向けに
~/Library/Application Support/もサポート - システム標準の場所を好むユーザーへの配慮
- macOSユーザー向けに
-
両方サポートする理由
- ユーザーの選択肢を増やす
- 既存のmacOSアプリの慣習に従う
現状の問題点
- Cmd+, が常に
~/Library/Application Support/を開く ~/.config/ghostty/configを使用している場合、混乱を招く- 将来のアップデートで改善される可能性あり
デフォルト設定の確認方法
すべての設定オプションとデフォルト値を表示
/Applications/Ghostty.app/Contents/MacOS/ghostty +show-config --default --docs | less現在読み込まれている設定を表示
/Applications/Ghostty.app/Contents/MacOS/ghostty +show-config利用可能なテーマ一覧
/Applications/Ghostty.app/Contents/MacOS/ghostty +list-themes利用可能なフォント一覧
/Applications/Ghostty.app/Contents/MacOS/ghostty +list-fontsトラブルシューティング
設定が反映されない場合
- 編集しているファイルを確認
ls -la ~/.config/ghostty/config- シンボリックリンクが正しいか確認
readlink ~/.config/ghostty
# → /Users/ginga/dotfiles/ghostty と表示されるべき- 設定ファイルの構文エラーを確認
- Ghostty起動時にエラーダイアログが表示される
- 該当行を修正して Cmd+Shift+, でリロード
macOS固有パスのファイルを削除したい場合
rm ~/Library/Application\ Support/com.mitchellh.ghostty/config- 削除しても問題なし(使用していないため)
~/.config/ghostty/configから正常に読み込まれる
参考リンク
- 公式ドキュメント: https://ghostty.org/docs/config
- 設定リファレンス: https://ghostty.org/docs/config/reference
- GitHub Issue(open_config問題): https://github.com/ghostty-org/ghostty/discussions/5516