Railsでの開発で “cannot load such file — bundler/setup (LoadError)” というエラーが出た場合の対処法およびその原因をご紹介します!

今回は、Railsでの開発で以下のエラー文が出てしまった時の対処法とその原因についてご紹介していこうと思います!

cannot load such file -- bundler/setup (LoadError)

エラー文、そしてその原因を丁寧に読み進めていけば、自ずとその解決方法が見えてくるかと思います。
(※あまりオススメはしませんが、結論のみ知りたい方はページ下部までスキップしてご確認ください。)


レバテックフリーランス … 業界最大級の案件数業界トップクラスの高単価報酬を誇る最大手のサービスです。実績豊富なコーディネーターが丁寧な対応をしてくれるため、案件の無理な提案はありません。フリーランスで生きていくためにはまず登録しておきましょう。
MidWorks … フリーランス賠償責任保障生命保険の折半など、フリーランスでありながらも正社員並みの保障を受けられるのが特徴です。また、経験豊富なキャリアコンサルタントによる手厚いサポートも受けられるため、安定したフリーランス生活を送りたい方には特におすすめのサービスです。
ポテパンフリーランス … IT業界・技術に詳しいコンサルタントが担当してくれるため、こちらの要望をきちんと理解した上で案件を紹介してくれます。また、案件情報のみならず、フリーランスのイロハについても教えてくれるため、フリーランスとして初めて活動される方には特におすすめのサービスです。

レバテックキャリア … ITエンジニアが利用したい転職エージェントNo.1にも選ばれており、年収600万円以上のハイクラス求人を5,000件以上も保有しています。エンジニアが転職を考えた時にまず初めに登録しておくべきサービスです。
Tech Stars Agent … Tech Stars Agentでは、担当エージェントが全員エンジニア出身のため、スキルやキャリアを見据えたきめ細かな転職支援が受けられます。運営元の株式会社Branding Engineerは、独立支援サービス「MidWorks」も展開しているため、独立を視野に入れたサポートも受けられます
転職ドラフト … 年収UP率93.8%/平均年収UP額126万円と圧倒的な年収UP率を誇るイベント型のエンジニア向け 転職サービスです。毎月1回開催され、厳選された優良IT/Web系企業約150社からダイレクトスカウトを受け取ることができます。年収アップを目指す方は登録必須です。

まずは日本語に直しましょう

cannot load such file -- bundler/setup (LoadError)

というエラーですが、日本語に直すと概ね以下のようになるかと思います。

"bundler/setup" というファイルが読み取れません

ではここで言う、”bundler” とは何なのでしょうか?

Bundlerとは?

Bundlerとは、gem同士の互換性を保ちつつ、その種類やバージョンを自動で管理してくれる便利な仕組みのことを指します。

ここで言う互換性とは、「AというgemをアップデートしたらBというgemが動かなくなってしまった…!」という事態を避けるということだと捉えていただいて結構です。

実際、Ruby on Railsでの開発では何十というgemが関わっており、それらを手動で管理するのはほぼ不可能に近く、Bundlerは不可欠な要素となっています

gemをまとめるBundlerも実はgem

さて、Bundlerの役割について理解したところで、エラー文に戻ってみましょう。

"bundler/setup" というファイルが読み取れません

というエラー文が出ておりましたが、素直に読み取ると、”bundler/setup” というファイルを追加すれば解消できそうですよね。

実はこの便利なBundlerくん、彼自身もgemなのです。数多くのgemをまとめるgemということになります。

「実はgemだった」という事実が判明した以上、やるべきことは一つ、RubyにBundlerというgemをインストールしましょう。

結論

以下を実行しましょう。

gem install bundler

実はこの “cannot load such file — bundler/setup (LoadError)” というエラーですが、Rubyのバージョンを切り替えたり新たなバージョンを使用し始める際に多く見られるエラーになります。

ここまで読み解けば当然のことだと分かるかと思いますが、Bundlerというgemをインストールしていない状態でgemを管理しようとしたがために発生してしまったエラーです。

Bundlerをインストールした後は、”bundle -v” を実行するとインストールされたBundlerのバージョンが表示されるかと思います。

お仕事の途中ですが、少し一休みして、転職独立について考えてみませんか🙌?

現役エンジニアが選ぶおすすめの転職エージェント11選【成功談・失敗談もあります】

レバテックフリーランスの評判ってどう?【現役エンジニアが徹底解説します】

MidWorks(ミッドワークス)の評判ってどう?【現役エンジニアが徹底解説します】

日々の業務に追われて自分を見失わないよう、
定期的にキャリアを振り返るようにしておきましょう🤲

最後に

さて、今回は “cannot load such file — bundler/setup (LoadError)” というエラーを通じてBundlerについての理解を深めてきましたがいかがでしたか?

エラーに直面した際にはただそのエラーを解消するだけでなく、その背景にある用語や技術についても確認しておくようにしましょう!

このブログを通じて少しでも「傍(はた)を楽(らく)にする」ことができていれば嬉しく思います。

最後まで読んで頂きありがとうございました。