Twowinn
iTerm2 세팅하기 - A to Z (mac os / M1) 본문
iterm2를 다운받으셨다면 이를 잘 활용하기 위해서는 많은 개발자 분들의 조언(!)에 따라 차근차근 설정해야 합니다.
초기 설정이 까다롭다면 까다로운데, 애를 썼기 때문에 블로깅하기로 마음먹었습니다. 😊
다른 대단한 블로거들에 비해 생략된 부분이 많을 수 있지만, 최대한 상세히 작성하려 합니다!
목차
0. iTerm2를 설치받으신 후 따라해주시면 감사하겠습니다!
1. Homebrew 설치
2. Zsh 설치 (최신 버전으로 업그레이드)
3. Oh My Zsh 설치
4. Agnoster 테마 설정
5. D2Coding (Nerd Font) 적용하기
6. 오류 해결 팁
1. Homebrew 설치
Homebrew는 macOS의 패키지 매니저로, 다양한 개발 도구를 설치할 때 사용합니다.
아래 명령어로 간단히 설치 가능합니다! (오류 시 homebrew 웹 사이트 에서 Install Homebrew 밑 명령어 작성 바랍니다.)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
M1칩을 사용자는 'help brew' 작성 시 이런 오류가 뜰 수 있습니다.
zsh: command not found: brew해결방법은 바로 아래 명령어를 입력해주면 됩니다~
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
2. zsh 설치 (최신 버전 업그레이드)
macOS에는 기본적으로 zsh가 설치되어 있지만, 최신 버전이 아닐 수 있습니다.
Homebrew를 이용해 최신 zsh를 설치하는 방법을 소개합니다.
1. zsh 설치
brew install zsh
2. zsh 버전 확인
zsh --version
ex) zsh 5.9 (arm-apple-darwin24.0.0)
3. zsh를 기본 쉘로 설정
chsh -s $(which zsh)
4. 세팅 확인
터미널을 다시 시작하고 아래 명령어로 zsh가 기본 쉘로 설정되었는지 확인합시다.
echo $SHELL저는 /bin/zsh 라고 출력되면서 성공적으로 되었습니다.
( /usr/local/bin/zsh 또한 성공적으로 설정된 것입니다!)
3. Oh My Zsh 설치
iTerm2의 강력한 기능을 활용하려면 Oh My Zsh 설치가 필요합니다. 아래 명령어로 간단히 설치해봅시다.
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"설치 후에 기본 쉘이 zsh로 설정되고, Oh My Zsh 환경이 적용 된 걸 볼 수 있습니다.
iterm의 터미널 프롬프트가 바뀌었다면 성공입니다.
echo $ZSH위 명령어를 통해 출력값이 설치경로 ( /Users/사용자명/.oh-my-zsh) 가 나온다면 Oh My Zsh가 정상적으로 설치 된 것입니다!
Oh My Zsh 기본 명령어
추가적으로 Oh My Zsh는 여러 유용한 명령어를 제공합니다. 설치 후 아래 명령어들을 알아 둡시다 :)
1. 플러그인 및 테마 업데이트
모든 플러그인과 테마를 최신 상태로 업데이트합니다:
omz update
2. 테마 변경 (후에 agnoster 테마 적용 시 다시 설명합니다!!)
테마를 변경하려면 .zshrc 파일의 ZSH_THEME 값을 수정한 뒤 아래 명령어로 적용합니다:
source ~/.zshrc
3. Oh My Zsh 재설치
문제가 발생했을 때 Oh My Zsh를 다시 설치합니다:
omz reinstall
4. Oh My Zsh 제거
Oh My Zsh를 완전히 제거하려면 아래 명령어를 실행합니다:
uninstall_oh_my_zsh
5. 도움말 확인
Oh My Zsh와 관련된 모든 명령어를 봅니다:
omz help4. Agnoster 테마 설정
Agnoster 테마는 깔끔하고 현재 열린 위치를 파악하기 좋습니다. 또한 많은 개발자 분들이 사용 중인 테마입니다!
Oh My Zsh 설치 후 기본적으로 제공되는 테마입니다.
1. .zshrc 파일 열기
nano ~/.zshrc
2. 테마 설정 변경
아래와 같은 새로운 창이 뜹니다.
ZSH_THEME="agnoster"이 부분이 다르게 되어 있을텐데 위 사진처럼 ""안쪽을 agnoster로 변경해주면 됩니다.
3. 변경 사항 저장
• Ctrl + O → Enter → Ctrl + X
• 이후 변경 사항을 적용합니다:
source ~/.zshrc5. D2Coding (Nerd Font) 적용하기
Agnoster 테마를 제대로 활용하려면 Nerd Fonts가 필요합니다.
일반적인 D2Coding 폰트를 많이들 사용하지만 제가 사용하면 테마에서 사용하는 특수 심볼(예: 화살표, 브랜치 아이콘, 체크 표시 등)이 깨지거나 제대로 표시되지 않았습니다.
이를 해결하기 위해, 확인해본 결과 Nerd Font 패치가 적용된 D2Coding Nerd Font를 사용해야 합니다.
왜 D2Coding Nerd Font(NF)인가?
• Nerd Font는 일반 폰트에 Powerline 심볼과 개발 관련 아이콘이 추가된 버전입니다.
• Agnoster 테마와 같은 고급 테마는 이 심볼을 사용해 깔끔하고 직관적인 프롬프트를 제공합니다.
• 일반 D2Coding 폰트는 이 심볼을 포함하지 않기 때문에, D2Coding Nerd Font를 선택해야 테마가 제대로 표시됩니다.
1) D2Coding Nerd Font 설치
1. D2Coding_Nerd에서 D2Coding Nerd Font를 다운로드합니다.
(.ttf 파일 하나를 골라 raw하시면 다운로드 됩니다)
2. 다운로드한 폰트를 macOS Font Book으로 열어 설치합니다. 두가지 방법이 있습니다.
.ttf 다운로드 - 저장된 파일 더블 클릭 / 자동으로 서체 관리자에 추가됨
.ttf 다운로드 - Spotlight에 '서체관리자' 검색 - 파일 - 현재 사용자에 서체 추가 - D2Coding_Nerd 추가
2) iterm2에서 폰트 설정
1. iTerm2 → Preferences(Settings) → Profiles → Text로 이동합니다.
2. Font 섹션에서 Change Font 버튼을 클릭합니다.
3. 설치된 D2Coding Nerd Font를 선택합니다.
+ 추가적으로 한글 깨짐 방지를 위해 Unicode normalization form : NFC 로 변경해줍니다.
3) Powerline 심볼 확인
터미널에서 아래 명령어를 실행해 심볼이 제대로 표시되는지 확인합니다:
echo "▲▼◆◇●○★☆⚡✂ → ←"모든 심볼이 올바르게 표시되면 성공입니다!!
6. 오류 해결 팁
* 테마 색상 문제
문제: Agnoster 테마의 색상이 흐리거나 글자가 잘 보이지 않습니다.
해결 방법:
agnoster 설정 이후 iterm2의 색상을 바꾼 기억을 하지 못해 계속 폰트가 깨지는 줄 알고 수차례 많은 시도를 했습니다...
여러분은 이러한 시행착오를 겪지 않으셨으면 해서 한번 더 강조드립니다!!
모든 설정 이후 iterm 터미널에 현 위치 부분이 안보이고 색이 칠해져 있다면!!!
1. iTerm2 → Preferences → Profiles → Colors → **Color Presets…**에서
적합한 색상 스킴(예: Solarized Dark, Powerline)을 선택합니다.
2. iTerm2의 배경 투명도를 조정하여 글씨를 더 명확하게 보이게 만듭니다.
이렇게 해결 먼저 해보시는게 좋을 듯 합니다..!
이 글을 따라하시다보면 iTerm2와 zsh를 세팅하실 수 있으실겁니다!
성공적인 세팅을 기원합니다 😉