macOS 환경에서 개발을 진행하다 보면 터미널을 통해 환경 변수를 설정해야 할 일이 자주 발생한다. 특히 macOS의 기본 Shell인 zsh를 사용할 때, ~/.zshrc 파일을 수정하여 새로운 경로를 추가하는 방법을 단계별로 정리해 본다.
Vim 에디터란?
터미널 환경에서 마우스 없이 키보드만으로 텍스트를 작성하고 수정할 수 있도록 구성된 강력하고 유연한 텍스트 편집기이다.
1. 현재 사용 중인 셸 확인
먼저 터미널을 열고 아래 명령어를 입력하여 현재 사용 중인 셸이 zsh인지 확인한다. 정상적이라면 /bin/zsh라는 결과가 출력된다.
echo $SHELL
2. Vim 에디터로 설정 파일 열기
zsh의 환경 변수 설정 파일인 .zshrc를 Vim 에디터로 실행한다.
vi ~/.zshrc
3. 입력 모드 진입하기
Vim이 실행되면 기본적으로 읽기 전용과 비슷한 Normal 모드 상태이다. 텍스트를 수정하려면 키보드에서 영문 i를 누른다.
화면 하단에 -- INSERT --라는 문구가 나타나면 성공적으로 텍스트를 입력할 수 있는 Insert 모드에 진입한 것이다.
4. 환경 변수 추가하기
방향키를 이용해 문서의 가장 아래쪽 빈 공간으로 이동한 뒤, 추가하려는 경로를 입력한다. 아래는 Flutter 환경 변수를 추가하는 예시이다. (경로는 본인의 PC 환경에 맞게 수정해야 한다.)
export PATH="$PATH:/Users/나의폴더명/flutter/bin"
5. 저장 후 종료하기
입력을 마쳤다면, 파일에 내용을 저장하고 에디터를 빠져나와야 한다. 이 과정이 처음 Vim을 접하는 사람들에게 가장 헷갈리는 부분이다.
- 키보드의
ESC키를 눌러 Insert 모드에서 빠져나온다. (하단의-- INSERT --문구가 사라지고 Normal 모드로 돌아옴) - 콜론
:을 입력하여 Command-line(명령어) 모드로 진입한다. - 화면 하단에
:가 나타나면wq를 입력하고Enter를 쳐서 저장 후 종료한다.
💡 자주 쓰이는 Vim 종료 명령어 모음
:q # 종료 (변경된 내용이 없을 때)
:w # 저장 (종료하지 않음)
:wq # 저장 후 종료
:q! # 변경된 내용을 무시하고 강제 종료 (실수했을 때 유용함)
:wq! # 강제로 저장 후 종료
6. 업데이트한 내용 적용하기
Vim 에디터에서 빠져나와 다시 터미널로 돌아왔다면, 방금 수정한 .zshrc 파일의 내용을 현재 터미널 세션에 즉시 반영해야 한다. 아래의 source 명령어를 사용한다.
source ~/.zshrc
7. 적용 확인하기
환경 변수가 제대로 설정되었는지 확인하기 위해 추가한 프로그램(여기서는 Flutter)의 명령어를 실행해 본다. 정상적으로 버전 정보가 출력된다면 환경 변수 설정이 완료된 것이다.
flutter --version
