[Ubuntu] Zsh + Oh My Zsh + Powerlevel10k 기반 개발용 터미널 환경 구축 가이드

우분투 기본 셸인 Bash는 안정적이지만, 생산성 측면에서는 Zsh 기반 환경이 더 효율적입니다.
본 문서는 Zsh + Oh My Zsh + Powerlevel10k + 필수 플러그인 조합을 통해
실무에서 사용하는 수준의 터미널 환경을 구축하는 방법을 설명합니다.

---

1. Zsh 설치 및 기본 셸 변경

Zsh를 설치하고 기본 로그인 셸로 변경합니다.

sudo apt update
sudo apt install zsh -y

# 기본 셸 변경
chsh -s $(which zsh)

적용을 위해 로그아웃 후 재접속 또는 터미널 재시작이 필요합니다.

---

2. Nerd Font 설치 (MesloLGS NF)

Powerlevel10k는 특수 아이콘을 사용하므로 Nerd Font 설치가 필수입니다.
권장 폰트: MesloLGS NF

설치 방법

1. 아래 4개 폰트 다운로드
   • MesloLGS NF Regular.ttf
   • MesloLGS NF Bold.ttf
   • MesloLGS NF Italic.ttf
   • MesloLGS NF Bold Italic.ttf
2. 터미널 폰트 변경
   • 경로: Terminal → Preferences → Profile → Text
   • Custom Font 활성화 → MesloLGS NF 선택
3.  우분투 Terminator(터미네이터) 폰트 변경 #1
   • 경로: Terminator → Preferences → Profile → Colors
   • Foreground and Background, Palette 변경
4.  우분투 Terminator(터미네이터) 폰트 변경 #2

nano ~/.config/terminator/config

[global_config]
[keybindings]
[profiles]
  [[default]]
    palette = "#2D353B:#E67E80:#A7C080:#DBBC7F:#7FBBB3:#D699B6:#83C092:#D3C6AA:#475258:#E67E80:#A7C080:#DBBC7F:#7FBBB3:#D699B6:#83C092:#E6E2CC"
    background_color = "#2D353B"
    foreground_color = "#D3C6AA"
    font = MesloLGS NF 15
    scrollback_infinite = True
    use_system_font = False
[layouts]
  [[default]]
    [[[window0]]]
      type = Window
      parent = ""
    [[[child1]]]
      type = Terminal
      parent = window0
[plugins]

폰트 미설치 시 아이콘이 깨져 보이며 테마 설정이 정상 동작하지 않습니다.

 

---

3. Oh My Zsh 설치

Zsh 설정을 관리하는 표준 프레임워크입니다.

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

설치 완료 시 .zshrc 파일이 자동 생성됩니다.

---

4. Powerlevel10k 테마 설치

Powerlevel10k는 성능과 가독성을 모두 고려한 Zsh 테마입니다.

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git \
${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

테마 적용

nano ~/.zshrc

ZSH_THEME="powerlevel10k/powerlevel10k"

저장 후 종료

---

5. 필수 플러그인 설치

5.1 자동완성 (zsh-autosuggestions)

git clone https://github.com/zsh-users/zsh-autosuggestions \
${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

5.2 문법 하이라이팅 (zsh-syntax-highlighting)

git clone https://github.com/zsh-users/zsh-syntax-highlighting.git \
${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

5.3 플러그인 활성화

nano ~/.zshrc

plugins=(git zsh-autosuggestions zsh-syntax-highlighting)

---

6. 설정 적용 및 초기 구성

source ~/.zshrc

실행 후 Powerlevel10k 설정 마법사가 자동 실행됩니다.

설정 시 확인 사항

• 아이콘 정상 출력 여부 (폰트 검증)
• Prompt 스타일 선택
• Git 상태 표시 여부
• 시간, 사용자 정보 표시 여부

재설정 필요 시

p10k configure

---

7. 문제 해결 (실무에서 자주 발생)

7.1 경고 메시지 발생

[WARNING]: Console output during zsh initialization detected.

원인

• .zshrc 실행 중 echo, printf, 로그 출력 존재
• 플러그인 초기화 순서 문제

해결 방법

• .zshrc에서 불필요한 출력 제거
• Powerlevel10k 관련 설정을 최상단 유지

---

7.2 아이콘 깨짐

원인

• Nerd Font 미설치 또는 적용 안됨

해결

• MesloLGS NF 폰트 재설치 후 터미널에 적용

---

7.3 Zsh 적용 안됨

echo $SHELL

결과가 /usr/bin/zsh가 아니면:

chsh -s $(which zsh)

---

8. 최종 구성 요약

구성 요소	역할
Zsh	확장 가능한 셸
Oh My Zsh	설정 관리 프레임워크
Powerlevel10k	고성능 테마
autosuggestions	명령어 자동 추천
syntax-highlighting	명령어 유효성 표시

---

결론

해당 구성을 적용하면 다음과 같은 효과를 얻을 수 있습니다.

• 명령어 입력 속도 향상
• Git 상태 가시성 증가
• 오타 및 오류 사전 방지
• 터미널 가독성 개선

즉, 단순한 UI 변경이 아닌 개발 생산성 향상 환경 구축입니다.