407 words
2 minutes
rbenvの設定方法について
概要
flutter開発していて、以下の構成で進めていたが、cocoapodsが不安定になってきたので、gemfileのバージョン固定に乗り換えるためにrbenvの設定方法についてまとめます。
- 元々の構成
| ツール | 管理 |
|---|---|
| rbenv | brew |
| ruby | brew |
| cocoapods | brew |
- Gemfile構成
| ツール | 管理 |
|---|---|
| rbenv | brew |
| ruby | rbenv/Gemfile |
| cocoapods | rbenv/Gemfile |
fastlaneなどを動かす場合は、同じくGemfileでバージョン固定するのが良さそう
1. Homebrewでrbenvをインストール
まずはパッケージマネージャーのHomebrewを使って、rbenvと、Rubyのビルドに必要なruby-buildをインストールします。
brew updatebrew install rbenv ruby-build2. シェルの設定(パスを通す)
インストールしただけではrbenvは動きません。お使いのシェル(多くの場合はZsh)の設定ファイルに、rbenvを初期化する記述を追加します。
echo 'eval "$(rbenv init -)" ' >> ~/.zshrcsource ~/.zshrcNote: Bashを使っている場合は
~/.zshrcを~/.bash_profileに読み替えてください。
3. Ruby 4.0.1 のインストール
次に、目的のバージョンをインストールします。
# インストール可能なリストを更新brew upgrade ruby-build
# 4.0.1 がリストにあるか確認rbenv install -l | grep 4.0.1
# インストール実行rbenv install 4.0.14. バージョンの切り替え
インストールが終わったら、PC全体(global)で使うバージョンを4.0.1に固定します。
rbenv global 4.0.1
# 反映を確認ruby -vよくあるトラブルと解決策
- 「4.0.1が見つからない」と言われる場合:
brew upgrade ruby-buildを実行して、rbenvが最新のRubyを知っている状態にしてください。 - ビルドエラーが出る場合: Xcode Command Line Toolsが必要です。
xcode-select --installを実行してから再度試してみてください。
rbenvの設定方法について
https://tutttuwi.github.io/posts/2026-03-13_setup-rbenv/