📖
Wezterm を試してみたメモ

2025/02/09に公開
Wezterm は設定ファイルによるカスタマイズが魅力のターミナルエミュレータです。

この記事では、Wezterm の設定ファイルの記載例と構成について説明し、初見の人がWeztermを使えるようになることを目指します。

なお、Windows を前提とした環境での設定例となります。

 インストールインストール方法は、公式サイト に記載されています。私はインストーラ（setup.exe）を使用しました。

 設定ファイルWezterm の設定ファイルは Lua スクリプトで記述します。公式サイト に従い、設定ファイルを $HOME/.config/wezterm/wezterm.lua に配置すれば OK です。

 サンプルコードサンプルコードを GitHub にアップロードしています。私の環境では、見やすさを考慮して、メインの設定ファイル wezterm.lua に加え、キーバインド用の keybinds.lua と起動メニュー用の launch_menu.lua の 3 つに分割しています。
各ファイルの役割は以下の通りです。

 1. wezterm.lua
メインの設定ファイル
外観や動作に関する基本設定を記述

keybinds.lua, launch_menu.luaを require を使って読み込み

 2. keybinds.lua
キーバインドの設定
コピー、貼り付け、タブ操作などのショートカットを設定

 3. launch_menu.lua
起動メニューの設定
Command Prompt、PowerShell、WSL2 などを起動するためのメニュー項目を定義
ショートカットから呼び出して各シェルを選択・起動できる

 設定ファイルの構成サンプルコードだけだと、自分の好みの設定に変えたい時に分かり辛いと思うので、構成について簡単に説明します。
Wezterm の設定ファイルはオブジェクト指向の考え方に基づいており、設定内容をひとまとめにした config オブジェクトに対して各種設定を施してます。最終的に、この config オブジェクトを返すことで、Wezterm は起動時にその内容を読み込み、ターミナルの動作や見た目を構築します。
local config = {}  -- 設定用のオブジェクト（テーブル）

-- 各種プロパティを設定
config.default_cwd = "C:/dev"
config.font = wezterm.font("Ricty Diminished")
config.font_size = 12
-- ...（他の設定項目もここに記述）

return config  -- このオブジェクトを返すことで、Wezterm が設定内容を取得

 Lua と JavaScript の比較個人的には、Lua の基本的な書き方は JavaScript に似た部分が多く、直感的に理解しやすいと感じました。

 変数宣言Lua:
local a = 10
JavaScript:
let a = 10;

 オブジェクト（テーブル）Lua のテーブルは、JavaScript のオブジェクトや配列に相当します。
Lua:
local person = { name = "Alice", age = 30 }
JavaScript:
const person = { name: "Alice", age: 30 };

 イベントハンドラLua:
wezterm.on('gui-startup', function(cmd)
  local tab, pane, window = wezterm.mux.spawn_window(cmd or {})
  window:gui_window():maximize()
end)
JavaScript:
wezterm.on('gui-startup', (cmd) => {
  const [tab, pane, window] = wezterm.mux.spawn_window(cmd || {});
  window.gui_window().maximize();
});

 まとめ以上の基本を理解した上で、あとは利用用途に応じて公式ドキュメントを参照すれば設定を変更していくことができると思います。参考になれば幸いです。