Ruby 설치 (rbenv)

rbenv란

rbenv는 Ruby 버전 관리 도구입니다. Python의 pyenv, Node.js의 nvm과 동일한 역할을 합니다. 시스템에 여러 Ruby 버전을 설치하고, 프로젝트별로 다른 버전을 사용할 수 있게 해줍니다.

시스템 Ruby(OS에 기본 설치된 Ruby)는 절대 사용하지 마세요. macOS는 Ruby 2.x가 기본 설치되어 있지만, 이는 OS 시스템 도구용이므로 개발에 사용하면 권한 문제와 버전 충돌이 발생합니다.

macOS 설치

Homebrew가 필요합니다. 없다면 https://brew.sh 에서 먼저 설치하세요.

# 1. rbenv와 ruby-build 설치brew install rbenv ruby-build# 2. 셸 초기화 스크립트에 rbenv 추가echo 'eval "$(rbenv init - zsh)"' >> ~/.zshrcsource ~/.zshrc# 3. Ruby 3.4 설치 (몇 분 소요)rbenv install 3.4.0# 4. 글로벌 기본 버전 설정rbenv global 3.4.0# 5. 설치 확인ruby --version# ruby 3.4.0 (2024-12-25 revision ...) [arm64-darwin24]

bash를 사용한다면 ~/.zshrc 대신 ~/.bash_profile에 추가하세요.

echo 'eval "$(rbenv init - bash)"' >> ~/.bash_profilesource ~/.bash_profile

Linux (Ubuntu 22.04+) 설치

# 1. 의존성 설치sudo apt-get updatesudo apt-get install -y git curl libssl-dev libreadline-dev \  zlib1g-dev autoconf bison build-essential libyaml-dev \  libreadline-dev libncurses5-dev libffi-dev libgdbm-dev# 2. rbenv 설치git clone https://github.com/rbenv/rbenv.git ~/.rbenvecho 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrcecho 'eval "$(rbenv init - bash)"' >> ~/.bashrcsource ~/.bashrc# 3. ruby-build 플러그인 설치git clone https://github.com/rbenv/ruby-build.git \  "$(rbenv root)"/plugins/ruby-build# 4. Ruby 3.4 설치rbenv install 3.4.0rbenv global 3.4.0# 5. 확인ruby --version

Windows: WSL2 사용

Windows에서는 WSL2(Windows Subsystem for Linux)를 사용하는 것을 강력히 권장합니다. Windows 네이티브 Ruby는 개발 도구 호환성 문제가 자주 발생합니다.

# PowerShell 관리자 권한으로 실행
wsl --install -d Ubuntu-22.04

설치 후 Ubuntu 터미널에서 위의 Linux 설치 과정을 따르세요. VS Code의 "Remote - WSL" 확장을 사용하면 WSL 내부 파일을 VS Code로 직접 편집할 수 있습니다.

설치 확인

# Ruby 버전 확인ruby --version# ruby 3.4.0 (2024-12-25 revision ...) [arm64-darwin24]# RubyGems(패키지 관리자) 버전 확인gem --version# 3.6.x# rbenv 버전 확인rbenv version# 3.4.0 (set by /Users/username/.rbenv/version)# Rails 설치 (gem 명령어 사용)gem install rails# Rails 버전 확인rails --version# Rails 8.0.x

Rails 설치에 1-2분 정도 소요됩니다. gem install rails는 Rails와 모든 의존 gem을 함께 설치합니다.

프로젝트별 Ruby 버전 고정

특정 프로젝트 디렉토리에서 사용할 Ruby 버전을 고정할 수 있습니다.

cd myprojectrbenv local 3.4.0     # .ruby-version 파일 생성cat .ruby-version     # 3.4.0

.ruby-version 파일이 있는 디렉토리에서는 rbenv가 자동으로 지정 버전을 사용합니다. 이 파일은 git에 포함해 팀 전체가 동일한 Ruby 버전을 사용하도록 합니다.