MENU
  1. ホーム
  2. Column
  3. Mac標準Rubyが古い問題を解決！初心者エンジニアがrbenvでRubyバージョン管理を始める完全ガイド

Mac標準Rubyが古い問題を解決！初心者エンジニアがrbenvでRubyバージョン管理を始める完全ガイド

Column
目次

はじめに：Mac標準RubyからrbenvでのRubyバージョン管理へ

MacのデフォルトRubyが古い理由とrbenvが必要な背景

macOSには最初からRubyがインストールされていますが、このバージョンは古く、現代的なRuby開発には不向きです。

# macOSデフォルトのRubyバージョンを確認
$ ruby -v
ruby 2.6.10p210 (2022-04-12 revision 67958) [universal.arm64e-darwin23]

Mac標準Rubyの問題点：

  • システムのRubyは古いバージョン（Ruby 2.6系）
  • 最新のgem（ライブラリ）が使えない
  • Rails 7系などの新しいフレームワークが動かない
  • システムのRubyを直接変更するのは危険

rbenvとは：Rubyバージョン管理ツールの基本概念

rbenvは複数のRubyバージョンを簡単に管理できるツールです。プロジェクトごとに異なるRubyバージョンを使い分けることができます。

GitHub
GitHub - rbenv/rbenv: Manage your app's Ruby environment Manage your app's Ruby environment. Contribute to rbenv/rbenv development by creating an account on GitHub.

Macでrbenvインストール前の環境確認方法

現在のRuby環境とMac環境を確認する手順

# 現在のRubyバージョン
$ ruby -v

# 現在のRubyのパス
$ which ruby
/usr/bin/ruby

# Homebrewがインストールされているか確認
$ brew --version
Ruby Programming Language
プログラミング言語 Ruby A Programmer's Best Friend

MacにHomebrewでrbenvをインストールする手順

Homebrewを使ったrbenvのインストール方法

# Homebrewをアップデート（時間がかかる場合があります）
$ brew update

# rbenvをインストール
$ brew install rbenv

# インストール確認
$ rbenv --version
rbenv 1.2.0
Homebrew
Homebrew The Missing Package Manager for macOS (or Linux).

既存rbenvをアップデートする場合のコマンド

# 現在のバージョン確認
$ rbenv --version

# アップデート
$ brew upgrade rbenv

# 確認
$ rbenv --version

rbenvの環境設定：MacのシェルでRubyバージョン管理を有効にする

MacのzshでrbenvのPATH設定を行う方法

macOS Catalina以降（zshの場合）：

# .zshrcファイルに設定を追加
$ echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.zshrc
$ echo 'eval "$(rbenv init -)"' >> ~/.zshrc

# 設定を反映
$ source ~/.zshrc

古いmacOS（bashの場合）：

# .bash_profileファイルに設定を追加
$ echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bash_profile
$ echo 'eval "$(rbenv init -)"' >> ~/.bash_profile

# 設定を反映
$ source ~/.bash_profile

rbenvが正しく設定されているかの確認方法

# rbenvが正しく設定されているか確認
$ rbenv init
# 以下のような出力が表示されればOK
# Load rbenv automatically by appending
# the following to ~/.zshrc:
# eval "$(rbenv init -)"

rbenvで最新Rubyをインストールする方法

rbenvでインストール可能なRubyバージョンを確認

# 利用可能なRubyバージョン一覧（多数表示されます）
$ rbenv install --list
Available versions:
  2.6.10
  2.7.8
  3.0.6
  3.1.4
  3.2.2
  3.3.0
  # ... 他多数

rbenvで最新安定版Rubyをインストールする手順

# Ruby 3.2.2をインストール（2024年時点の安定版）
$ rbenv install 3.2.2

# ⚠️ 注意：インストールには5-10分かかる場合があります
# "Installing ruby-3.2.2..." と表示されたら待ちましょう

rbenvでインストールしたRubyバージョンの確認方法

# インストール済みRubyバージョン一覧
$ rbenv versions
* system (set by /Users/username/.rbenv/version)
  3.2.2

# ⭐が付いているのが現在アクティブなバージョン

rbenvでRubyバージョンを切り替える方法

rbenvでグローバルRubyバージョンを設定する手順

# 新しいRubyをグローバルに設定
$ rbenv global 3.2.2

# 設定確認
$ rbenv version
3.2.2 (set by /Users/username/.rbenv/version)

# 実際のRubyバージョン確認
$ ruby -v
ruby 3.2.2p53 (2023-03-30 revision e51014f9c0) [arm64-darwin23]

rbenvでプロジェクト別にRubyバージョンを設定する方法

# プロジェクトディレクトリで実行
$ cd /path/to/your/project
$ rbenv local 3.1.4

# そのディレクトリでのみRuby 3.1.4が使用される
$ ruby -v
ruby 3.1.4p223 (2023-03-30 revision 957bb7cb81) [arm64-darwin23]

rbenvのトラブルシューティング：よくあるRubyバージョン管理の問題と解決法

rbenvでRubyバージョンが切り替わらない場合の対処法

$ rbenv version
3.2.2 (set by /Users/username/.rbenv/version)

$ ruby -v
ruby 2.6.10p210 (system version)  # まだ古いバージョン

解決方法：

# シェル設定が読み込まれていない可能性
$ source ~/.zshrc  # または ~/.bash_profile

# それでも解決しない場合、新しいターミナルを開く

rbenvのRBENV_VERSION環境変数エラーの解決方法

$ rbenv versions
  system
* 3.1.2 (set by RBENV_VERSION environment variable)  # ←これが問題
  3.2.2

解決方法：

# 環境変数をリセット
$ rbenv shell --unset

# 確認
$ rbenv versions
  system
  3.1.2
* 3.2.2 (set by /Users/username/.rbenv/version)

rbenvでgemがインストールできない場合の対処法

$ gem install rails
ERROR: While executing gem ...

解決方法：

# rehashを実行（新しいgemを認識させる）
$ rbenv rehash

# 再度試行
$ gem install rails

rbenvでRuby環境構築後のRails開発実践

rbenvでインストールしたRubyにRailsをインストールする方法

# Railsをインストール
$ gem install rails

# バージョン確認
$ rails -v
Rails 7.1.0

# 新しいRailsアプリを作成
$ rails new sample_app
$ cd sample_app

# 開発サーバー起動
$ rails server
# => http://localhost:3000 でアクセス可能

rbenv環境でbundlerを使ったgemの管理方法

# bundlerをインストール（通常は最初から入っています）
$ gem install bundler

# Gemfileがあるプロジェクトで依存関係をインストール
$ bundle install

rbenvコマンド一覧：Rubyバージョン管理で使う基本コマンド

# rbenvの基本コマンド
$ rbenv versions           # インストール済みバージョン一覧
$ rbenv version            # 現在のバージョン
$ rbenv global 3.2.2       # グローバルバージョン設定
$ rbenv local 3.1.4        # ローカルバージョン設定
$ rbenv install --list     # インストール可能バージョン一覧
$ rbenv install 3.2.2      # 指定バージョンのインストール
$ rbenv uninstall 3.1.4    # 指定バージョンのアンインストール
$ rbenv rehash             # 新しいgemコマンドを認識
$ rbenv shell --unset      # シェルレベルのバージョン設定を解除

まとめ：rbenvでMacのRubyバージョン管理を成功させるポイント

rbenvでのRuby環境構築成功チェックリスト

✅ ruby -v で新しいバージョンが表示される
✅ which ruby で /Users/username/.rbenv/shims/ruby と表示される
✅ gem install でgemがインストールできる
✅ rails new で新しいアプリが作成できる

rbenvを使ったRubyバージョン管理のベストプラクティス

プロジェクトごとに.ruby-versionファイルを作成**

$ echo "3.2.2" > .ruby-version

定期的にRubyバージョンを更新

$ rbenv install --list | grep -E "^\s*[0-9]+\.[0-9]+\.[0-9]+$" | tail -5

使わないバージョンは削除してディスク容量を節約

$ rbenv uninstall 2.7.8

rbenv導入後のRuby学習ステップ

Ruby基礎学習: 新しい環境でRubyの基本構文を学習 Rails入門: rails newコマンドでWebアプリ開発を始める Gem管理: bundlerを使った依存関係管理を理解 テスト環境: RSpecなどのテストフレームワークを導入

参考リンク

Column
Engineer Rails Ruby 環境構築
よかったらシェアしてね！
  • URLをコピーしました！
  • URLをコピーしました！

関連記事

目次