피로에 살고 피로에 죽자

Mac OS에서 기본 셸로 zsh를 사용하다 보면 터미널 환경을 구성할 때 자동 완성 기능이 제대로 작동하지 않아 당황스러운 상황이 생기기도 하더라고요. 특히 자주 사용하는 도구의 옵션을 입력할 때 탭 키를 눌러도 아무런 반응이 없으면 전체 명령어를 매번 직접 타이핑해야 하니 작업 속도가 더뎌지기 마련이죠. 이런 불편함을 해소하기 위해 zsh-completions를 도입하면 훨씬 직관적이고 편리한 터미널 환경을 구축할 수 있거든요. 단순히 기본 기능만 사용하는 것이 아니라 다양한 오픈소스 도구들과의 호환성을 높여주는 역할을 수행하기 때문이에요. 이를 통해 터미널이 단순한 입력창을 넘어 개발자의 의도를 정확하게 파악하고 도움을 주는 도구로 활용될 수 있어요.

먼저 Homebrew를 활용해 zsh-completions를 설치하는 과정이 필요해요. 터미널에서 brew install zsh-completions 명령어를 실행하면 관련 파일이 설치되는데요. 여기서 중요한 점은 설치만 한다고 바로 적용되는 것이 아니라 zsh 설정 파일인 .zshrc에 fpath를 등록하고 compinit을 호출하는 과정이 필수적이라는 점이에요. 이 과정이 누락되면 설치를 했음에도 불구하고 자동 완성 기능이 활성화되지 않는 경우가 많더라고요. 특히 환경 변수나 경로 설정이 꼬여있는 경우라면 더욱 세심하게 확인하며 진행해야 하거든요.

brew install zsh-completions

설정 경로를 등록할 때는 본인이 사용하는 Mac의 하드웨어 사양에 따라 경로가 달라질 수 있다는 점을 유의해야 해요. Apple Silicon 칩이 탑재된 Mac이라면 /opt/homebrew/share/zsh-completions 경로를, 인텔 프로세서를 사용하는 Mac이라면 /usr/local/share/zsh-completions 경로를 fpath에 추가해야 하거든요. .zshrc 파일 하단에 fpath=(/opt/homebrew/share/zsh-completions $fpath)와 autoload -U compinit && compinit를 추가하면 시스템이 자동 완성 스크립트를 어디에서 찾아야 하는지 알려주는 역할을 합니다. 설정이 완료된 후에는 source ~/.zshrc 명령어를 입력하거나 터미널을 재시작하면 모든 설정이 즉시 반영되더라고요. 이렇게 한 번만 제대로 설정해두면 앞으로 터미널에서 명령어를 입력할 때 탭 키를 눌러 자동 완성되는 기능을 마음껏 활용할 수 있어요. 오타를 줄이고 작업 흐름을 끊지 않으면서도 생산성을 높일 수 있는 핵심적인 환경 구성이라서 Mac OS를 사용하는 개발자라면 꼭 한 번 적용해볼 만한 기능인 것 같아요. 터미널 환경이 훨씬 쾌적해지는 것을 체감할 수 있을 거예요.