Railsの環境構築(エラー対処録)

Railsの環境設定で手こずったので解消するまでやったことを書き留めていきます。

MacのOSは Catalina10.15.7です。

バージョンは最終的に以下のようになります

rbenv 1.1.2
Bundler 2.0.2
Ruby 2.7.5
Rails 5.2.3

1:Homebrewをインストール

Homebrewは、ソフトウェアの導入を単純化するMac OSのパッケージ管理システムです。

下記のURLからHomebrewをインストールします。

Homebrew

2:rbenvをインストールする

rbenvをインストールします。rbenvをインストールすることでrubyのバージョンの切り替えが容易にできるようになります。

brew install rbenv
brew install ruby-build

ruby-buildをインストールすることで、rbenv installというコマンドを使うことができます。

上記のコマンドを実行したらrbenvがインストールされているか確認します。以下のコマンドを実行してバージョンの情報が表示されていればインストールされています。

rbenv --version
rbenv 1.1.2

3:rbenvにPATHを通す

rbenvコマンドを利用するために、rbenvにPATHを通します。PATHを通すとは、コマンド実行ファイルを探しに行くパスを追加することです。

echo 'export PATH="HOME/.rbenv/bin:PATH"' >> ~/.bash_profile
echo 'if which rbenv > /dev/null; then eval "(rbenv init -)"; fi' >> ~/.bash_profile
source ~/.bash_profile

4:Rubyをインストールする

下記のコマンドでRubyをインストールします。

 rbenv install 2.5.1

次にグローバルで利用するバージョンを設定します。

 rbenv global 2.5.1

次にRubyのバージョンの情報を確認します。

ruby -v
ruby 3.0.0    ←ここでグローバルに変わっていない

5:rbenvにPATHを通す

OSがCatalinaでzshなのでPathを変えてみました。

~/.zshenvに
export PATH="/usr/local/bin:$PATH"
export PATH="$HOME/.rbenv/bin:$HOME/.rbenv/shims:$PATH" # この一行を追加

↑最後の一行を追加し、~/.zshrcに

~/.zshrc
source $HOME/.zshenv

を追加しました。

またRubyのバージョンの情報を確認します。

ruby -v
ruby 3.0.0    ←グローバルに変わっていない

ここで↓のコマンドで.ruby-versionを確認したところ

vi /Users/ユーザー名/.ruby-version

3.0.0となっていたので
2.5.1に変更します。(iでINSERTモードにして、2.5.1に書き換えてからEscを押して、:wqで上書き保存する)

ruby -v
ruby 2.5.1 ←2.5.1に変わった

6:bundlerをインストールする

bundlerとはGem同士の互換性を保ちながらパッケージの種類やバージョンを管理してくれる仕組みのことです。

bundlerをインストールします。

gem install bundler

上記のコマンドを実行したらbundlerのバージョンを確認します。バージョン情報が表示されていればインストールされています。

bundler -v
Bundler version 2.0.2

7:Railsをインストールする

最後にRailsをインストールします。以下のコマンドを実行します。

gem install rails -v 5.2.3

実行ができたら以下のコマンドでRailsのバージョンを確認します。

rails -v

bin/rails:3:in `require_relative': cannot load such file -- /Users/caimユーザー名/Desktop/config/boot (LoadError)
from bin/rails:3:in `<main>'

エラーでrailsコマンドが使えない・・・

sudoをつけてもう1回試してみる

sudo gem install rails -v 5.2.3

次のようなエラーが出ました

ERROR: Error installing rails:
There are no versions of activesupport (= 7.0.2.2) compatible with your Ruby & RubyGems. Maybe try installing an older version of the gem you're looking for?
activesupport requires Ruby version >= 2.7.0. The current ruby version is 2.6.9.207.

rubyのバージョンを2.7.0以上にしろと言ってるので

rbenv install 2.7.5
vi /Users/ユーザー名/.ruby-version

2.7.5に変更します。(iでINSERTモードにして、2.7.5に書き換えてからEscを押して、:wqで上書き保存する)

rbenv global 2.7.5
ruby -v
ruby 2.7.5p203 (2021-11-24 revision f69aeb8314) [x86_64-darwin19]

2.7.5に変わったので、railsを再インストールします。

sudo gem install rails -v 5.2.3

インストールできているか確認します。

rails -v 

Rails is not currently installed on this system. 
To get the latest version, simply type:

   $ sudo gem install rails
You can then rerun your "rails" command.

↑のようなメッセージが出たので、↓のコマンドをします。

hash -r

確認します。

rails -v
Rails 5.2.3

長かったですがなんとか環境構築できました。

コメントを残す

メールアドレスが公開されることはありません。 が付いている欄は必須項目です