맥북 루비 버전 업그레이드 하는 최신 설치 방법

루비(Ruby)는 Jekyll과 같은 특정 개발 환경을 이용하기 위해 필수로 요구되는 언어입니다. 특히 GitHub Pages에서 Jekyll 기반 사이트를 실행하려면 최신 버전 Ruby가 필요합니다.

하지만 macOS에는 기본으로 구버전 루비가 설치돼 있습니다. 이제 버전 업그레이드 과정에서 어려움을 겪을 수 있습니다. 이 포스팅에서는 맥북에서 루비 버전 업그레이드 하는 방법을 알아보았습니다.

Table of Contents

어려운 이유

이유는 맥북에 이미 루비가 설치돼 있기 때문입니다. 하지만 2버전이 설치돼 있어 버전을 올려야 합니다.

macOS의 시스템 Ruby는 운영체제의 필수 구성요소입니다. 설치 경로는 /usr/bin/ruby입니다. 이 기본 설치된 Ruby는 주로 시스템 내부의 스크립트와 도구들을 위해 사용되며, 2.6.x 버전으로 구버전입니다.

시스템 Ruby는 운영체제의 안정성을 위해 수정이 제한돼 있습니다. 개발 환경에서 요구하는 최신 기능을 지원하지 않는 경우가 많습니다. 따라서 개발 목적으로는 별도의 Ruby 환경을 설치해야 합니다.

루비 설치 방법

맥북에서는 홈브류를 이용하면 쉽게 프로그램을 설치합니다. brew install ruby 명령어로 바로 설치해도 되지만, 이렇게 하면 버전 관리가 어렵습니다.

그래서 rbenv를 이용하면 좋습니다. rbenv는 프로젝트별로 다른 루비 버전을 관리하게 해주는 강력한 버전 관리 도구입니다. pyenv와 동일한 개념입니다.

설치는 아래 방법을 참고해서 진행하세요.

rbenv 설치

먼저 홈브루를 통해 필요한 도구를 설치합니다.

brew update
brew install rbenv

ruby-build를 먼저 설치하라고도 하는데, rbenv를 설치하면 ruby-build도 설치가 됩니다.

루비 설치

rbenv를 설치하면 install 명령을 통해 내가 원하는 버전의 루비를 설치할 수 있습니다. 루비 3.3.5를 아래와 같이 설치합니다.

rbenv install 3.3.5

global은 맥북 어디에서도 ruby를 실행하면 3.3.5 버전이 실행되게 하는 명령입니다. 설치 후 global 명령도 실행합니다.

rbenv global 3.3.5

루비 실행

이제 터미널에서 ruby를 실행할 때 3.3.5 버전이 실행되면 됩니다. 하지만 제 경우 2.6.x 버전이 실행됐습니다. 이는 PATH 환경 변수 문제입니다. 이를 해결하기 위해 init을 실행합니다.

rbenv init

위와 같이 실행하면 ~/.zprofile에 초기화 명령어가 들어갑니다. 초기화 명령이 제대로 실행되면 ruby를 입력했을 때 3점대 버전이 실행됩니다.

~/.zprofile은 처음 로그인할 때 실행되는 파일인데, 왠일인지 실행되지 않습니다. 그래서 파일 안에 있는 명령을 ~/.zshrc 파일에 넣어줬다니 잘 적용이 됩니다.

참고로 정리하면 ~/.zshrc 파일에 아래 코드가 있어야 합니다.

eval "$(rbenv init -)"

코드를 넣은 후에는 터미널을 새로 켜도 되고, 아니면 source ~/.zshrc로 설정 파일을 실행합니다.

버전 확인

다음 명령어로 루비 버전을 확인합니다.

ruby -v
which ruby

rbenv를 사용한 루비 설치는 macOS에서 개발 환경을 구축할 때 가장 안정적이고 효과적인 방법입니다. 시스템 루비를 건드리지 않고도 최신 버전의 Ruby를 사용합니다. 또한 필요에 따라 여러 버전을 전환하며 사용할 수 있습니다. 맥북에서 최신 버전 루비를 사용하는데 어려움이 있는 분들에게 도움이 됐기를 바랍니다.