WezTerm 사용을 위한 기본 셋팅 참조

 맥북(macOS) 환경에서 WezTerm을 최적으로 세팅하는 방법을 단계별로 정리하였다.
이 구성은 iTerm2 → WezTerm으로 전환하려는 개발자**(특히 Rust, Neovim, Git, Tmux 사용자)** 기준으로 하였다.

---

🧠 WezTerm 맥북 최적 세팅 가이드

1️⃣ 설치

방법 1: Homebrew (추천)

brew install wezterm

방법 2: 공식 dmg

https://wezfurlong.org/wezterm/
→ 최신 macOS 빌드 다운로드 후 /Applications에 넣기.

---

2️⃣ 기본 설정 파일 생성

WezTerm은 설정을 Lua로 작성합니다.
위치는 다음 경로:

mkdir -p ~/.config/wezterm
touch ~/.config/wezterm/wezterm.lua

---

3️⃣ 추천 폰트 설정

WezTerm은 Nerd Font 기반 폰트 사용을 강력히 권장합니다.
다음 명령으로 JetBrainsMono Nerd Font 설치:

brew tap homebrew/cask-fonts
brew install --cask font-jetbrains-mono-nerd-font

---

4️⃣ 추천 기본 설정 (wezterm.lua)

아래 코드는 “성능 + 미려함 + Neovim 호환성”에 최적화된 세팅입니다.

local wezterm = require("wezterm")
local act = wezterm.action

return {
  -- 🎨 테마
  color_scheme = "Gruvbox Dark",
  font = wezterm.font_with_fallback({
    "JetBrainsMono Nerd Font",
    "Apple Color Emoji",
  }),
  font_size = 13.0,

  -- 💨 성능 및 렌더링
  freetype_load_target = "Light",
  freetype_render_target = "HorizontalLcd",
  front_end = "WebGpu", -- WebGPU 렌더링 (빠름)

  -- 🪄 UI 관련
  enable_tab_bar = true,
  hide_tab_bar_if_only_one_tab = true,
  use_fancy_tab_bar = true,
  tab_bar_at_bottom = false,
  window_decorations = "RESIZE",
  window_background_opacity = 0.93,
  macos_window_background_blur = 20,

  -- 🔑 단축키 (iTerm2 스타일 비슷하게)
  keys = {
    { key = "t", mods = "CMD", action = act.SpawnTab("CurrentPaneDomain") },
    { key = "w", mods = "CMD", action = act.CloseCurrentTab({ confirm = true }) },
    { key = "Enter", mods = "CMD", action = act.ToggleFullScreen },
    { key = "LeftArrow", mods = "CMD|ALT", action = act.ActivateTabRelative(-1) },
    { key = "RightArrow", mods = "CMD|ALT", action = act.ActivateTabRelative(1) },
    { key = "d", mods = "CMD", action = act.SplitHorizontal({ domain = "CurrentPaneDomain" }) },
    { key = "d", mods = "CMD|SHIFT", action = act.SplitVertical({ domain = "CurrentPaneDomain" }) },
  },

  -- 🧭 탭, 분할창 제목 포맷
  tab_max_width = 25,
  tab_and_split_indices_are_zero_based = true,

  -- 🧰 shell 설정 (기본 zsh / fish / bash)
  default_prog = { "/bin/zsh", "-l" },

  -- 🔧 창 크기 / 기본값
  initial_rows = 40,
  initial_cols = 120,
}

💡 참고: color_scheme은 wezterm show-colors로 미리보기가 가능.
인기 테마: "Gruvbox Dark", "Tokyo Night", "OneHalfDark", "Catppuccin Mocha"

---

5️⃣ Neovim / 개발 환경 연동 팁

✅ Neovim 글꼴과 색상 맞추기

init.lua 또는 init.vim 내에 다음 추가:

vim.o.termguicolors = true

WezTerm은 true color를 완벽히 지원하므로 색 표현이 정확해집니다.

✅ Tmux 대체

WezTerm 자체가 탭과 분할 지원하므로
tmux를 완전히 대체 가능:

• ⌘ + D → 가로 분할
• ⇧⌘ + D → 세로 분할
• ⌘ + ⌥ + ←/→ → 탭 이동

원하면 wezterm.mux API로 tmux-style 세션 스크립트를 작성할 수도 있습니다.

---

6️⃣ 자동화 / 조건부 설정 예시 (고급)

local wezterm = require("wezterm")

local config = {}

if wezterm.target_triple == "x86_64-apple-darwin" then
  config.font_size = 13.0
else
  config.font_size = 11.0
end

config.color_scheme = "Catppuccin Mocha"
config.enable_scroll_bar = false

return config

→ macOS / Linux 환경을 구분하거나, 화면 크기에 맞춰 다르게 설정할 수 있음.

---

7️⃣ 추천 추가 설정

목적	설정	설명
창 투명도	window_background_opacity = 0.9	배경 투명 효과
블러 효과	macos_window_background_blur = 20	macOS 특유의 유리 느낌
애니메이션 제거	animation_fps = 1	퍼포먼스 향상
GPU 프론트엔드	front_end = "WebGpu"	렌더링 성능 개선

---

8️⃣ 문제 해결 팁

문제	해결 방법
폰트 깨짐	Nerd Font 설치 후 wezterm.font_with_fallback 사용
터미널 컬러 이상	termguicolors 활성화 확인
키바인딩 안 먹힘	CMD 키 → “macOS 단축키 충돌” 확인 (시스템 설정에서 수정 가능)

---

🎁 추천 확장 테마 모음

• Catppuccin: color_scheme = "Catppuccin Mocha"
• Tokyo Night: "Tokyo Night Storm"
• One Dark (JetBrains 스타일): "OneHalfDark"
• Gruvbox Dark: "Gruvbox Dark (Hard)"

미리보기:

wezterm show-colors

---

✅ 정리 요약

항목	권장 값
폰트	JetBrainsMono Nerd Font
테마	Gruvbox Dark / Catppuccin
렌더링 엔진	WebGPU
탭 관리	CMD + T / W
분할 단축키	CMD + D, SHIFT + CMD + D
배경 효과	투명도 0.9 + Blur 20
기본 셸	Zsh

 

---

© 2025@goooodday | 본 글은 AI 초고를 바탕으로 작성되었으며,
무단 전재·배포·상업적 이용을 금지하며, 인용시 출처를 표기해주세요.