ホーム 芸能ニュース・ゴシップ requireの意味とエラーの真相|importとの違いと最新モジュール仕様

requireの意味とエラーの真相|importとの違いと最新モジュール仕様

大槻 彩花 大槻 彩花 • 更新: • 公開: • 読了約 18 分
目次

プログラミングの学習中や開発現場のコードベースで毎日のように目にする「require」。日常英語としてはもちろん、JavaScript(Node.js)やPHPなど複数の言語で中心的な役割を担ってきたキーワードですが、実行時に突如現れる「require is not defined」というエラーに頭を抱えた経験を持つエンジニアは少なくありません。

なぜこのエラーは頻発するのか、そしてモダン開発で標準となった「import」とは一体何が根本的に異なるのか。2026年現在のWebエコシステムにおける最新のモジュール仕様や背景事情を交えながら、構文の深層から現場目線のトラブルシューティングまでを徹底的に解剖します。

【語源とニュアンス】requireの意味と英語での使い方|needやdemandとの決定的な差

requir

プログラミング構文の理解を深める上でも、まずは原義であるrequireの意味と英語での使い方を正確に把握しておくことが極めて有益です。ラテン語の「requirere(再び探し求める)」を語源とするrequireは、単に「欲しい」と思う感情ではなく、「特定の規則、法律、客観的条件を満たすために必然的に求められる」という強い拘束力を持ちます。

日常会話やビジネス英語において、requireとneedやdemandのニュアンスの違いは以下のように明確に分かれています。

・need:話し手の主観的な欲求や、状況的に不足しているものを「必要とする」ニュアンス。個人の感情や裁量が色濃く反映されます。
・require:客観的な規則、システム要件、法的拘束力によって「必要とされる・義務付けられる」ニュアンス。仕様書にある「System Requirements(動作環境・必要条件)」や「Passengers are required to...(乗客は〜することが義務付けられています)」のように、公的な基準に準拠します。
・demand:力関係や強い権利意識を背景に、相手に対して「強く要求する・請求する」ニュアンス。時に一方的・強硬な響きを伴います。

プログラミング言語における「require」が、スクリプト実行において「対象のファイルやライブラリが存在しなければ処理を成立させない」という厳密な前提条件を指すのは、まさにこの客観的な必然性という語源に由来しています。

【徹底解剖】requireとimportの決定的な違いと構文の仕組み

多くの初学者や移行期の開発者が直面する疑問が、「なぜrequireとimportという2つの読み込み方法が混在しているのか」という点です。この2つは単なる書き方の違いではなく、内部で動作するタイミングと設計思想そのものが根本から異なります。

最初に、require構文の仕組み詳細まとめを整理すると、これはサーバーサイドJavaScriptの黎明期に策定された「CommonJS(CJS)」仕様に準拠しています。最大の特徴は、ランタイム実行時の「動的かつ同期的な読み込み」です。コードが上から順に実行される途中でrequire文に到達した瞬間、指定されたファイルをファイルシステムから同期的に読み込み、評価してキャッシュに格納します。そのため、if文のブロック内や関数の中で条件に応じて読み込むパスを切り替えるといった動的な記述が容易でした。

一方の「import」は、ECMAScript公式標準である「ES Modules(ESM)」の構文です。こちらは「静的解析(Static Analysis)」を前提として設計されており、コードが実行される前の構文解析フェーズで依存関係のグラフを構築します。この静的解析のおかげで、未使用のコードをバンドル時に削ぎ落とす「Tree Shaking」や、非同期での並列モジュール読み込みが可能となり、ブラウザの高速化に劇的な貢献をもたらしました。

項目 require(CommonJS) import(ES Modules) 編集部の見解・評価
規格の発祥と策定 Node.js独自の採用(CommonJS) ECMAScript標準仕様(ES2015〜) Web標準は完全にESMに移行完了
評価・実行タイミング 実行時(Runtime)に同期評価 パース時(Parse)に静的解析・非同期 最適化(Tree Shaking)の可否を分ける
記述可能な場所 関数内や条件分岐(if文)の中でも可 原則ファイル最上位(トップレベル)のみ import()関数を使えば動的取得も可能
ブラウザ環境での直接動作 非対応(バンドラー必須) 対応(<script type="module">) フロントエンド直接実行の決定的な差

requireとimportの決定的な違いは、「実行時に同期的に読み込む古いサーバー専用の仕組み」か、「事前に静的解析を行って最適化するブラウザ・サーバー共通の標準仕様」かという点に集約されます。

【トラブル検証】requireエラーが出る理由と対処法|「is not defined」の真相

開発者を最も悩ませるrequireエラーが出る理由と対処法について、代表的な2大パターンの根本原因を紐解きます。その筆頭が、画面やコンソールに赤文字で突きつけられる「ReferenceError: require is not defined」です。

真相1:ブラウザ環境でrequireが動かない理由

HTMLファイルから読み込んだ通常のJavaScriptコード内で const x = require('lib') と書くと、ブラウザは即座にエラーを吐き出します。ブラウザ環境でrequireが動かない理由は極めて明快で、require関数はNode.jsというサーバー環境の実行エンジンがグローバルスコープに独自注入している関数であり、Webブラウザの標準JavaScriptエンジン(V8やJavaScriptCoreなど)には最初から実装されていないためです。

ブラウザ上でCommonJSコードを動かすためには、WebpackやVite、esbuildといったビルドツールを用いて1つのファイルに依存関係を結合するか、ブラウザが標準解釈できる と import 構文に書き換える必要があります。

真相2:package.jsonの "type": "module" 設定によるCJSの遮断

Node.js環境であるにもかかわらず「require is not defined」が発生する場合、require is not definedの真相はプロジェクト設定にあります。近年のNode.jsプロジェクトで package.json に "type": "module" と記述している場合、そのプロジェクト内のすべての .js ファイルはES Modulesとして解釈されます。

ESMのスコープ内では、CommonJS由来のグローバル変数である require や dirname、filename は自動的に未定義(undefined)となります。この場合の現実的な対処法は3通り存在します。

1. import構文へ書き換える:推奨される最もクリーンな方法です。
2. 拡張子を「.cjs」に変更する:ファイル単位でCommonJSであることを明示指定します。
3. createRequireを使用する:ESMコード内で一時的にrequireを生成するテクニックです。

``javascript // ESM環境下で例外的にrequireを使いたい場合のコード例 import createRequire from 'node:module'; const require = createRequire(import.meta.url); const data = require('./legacy-package.json'); ``

【2026年最新動向】CommonJSからESModulesへの移行経緯と仕様の現在地

歴史を振り返れば、CommonJSからESModulesへの移行経緯は決して平坦な道のりではありませんでした。2015年にES6(ECMAScript 2015)でimport/exportが標準化されて以降、コミュニティは約10年近くにわたり「モジュールフォーマットの分断」という深刻な痛みを経験してきました。

Node.jsコミュニティにおける「デュアルパッケージの苦難(Dual Package Hazard)」はその象徴です。npm上に公開されたライブラリがCJS向けとESM向けで二重にインスタンス化されて予期せぬバグを引き起こしたり、トップレベルawaitの扱いを巡って激しい議論が巻き起こりました。

しかし、2026年最新のJavaScriptモジュール仕様において、この状況は新たな均衡を迎えています。Node.js 22以降、フラグなしで require() を使って同期的なES Modulesをロードできる機能(require(esm))の実験的導入から安定化が進み、BunやDenoといった後発の高速ランタイムが優れた相互運用性(相互透過的なimport/require)を提供したことで、ツールチェーンの軋轢は大幅に緩和されました。

現在におけるNodejsにおけるrequireの現在の位置づけは、「第一選択肢ではないが、既存の膨大な資産を支える強固な互換レイヤー」として完全に落ち着きを見せています。新規プロジェクトはESM一択でありながらも、requireが突然完全に削除されて動かなくなるような破壊的変更は避けられています。

補足:PHPにおけるrequireとincludeの違いとは

なお、Web開発の文脈ではPHPにおけるrequireとincludeの違いも頻出のテーマです。JavaScriptのCJS/ESM論争とは異なり、PHPではエラー発生時の挙動の重さが分岐点となります。

・include:指定ファイルが見つからない場合、E_WARNING(警告)を出すが処理を続行する。
・require:指定ファイルが見つからない場合、E_COMPILE_ERROR(致命的エラー)を発生させ、スクリプト全体の実行をその場で即時停止する。

データベース接続設定や認証ロジックなど、欠落するとシステムの致命傷になるモジュールには require(あるいは二重読み込みを防ぐ require_once)を用いるのが安全設計の基本原則です。

【実態検証】エンジニア界隈のネットの反応と現場目線のリアル

技術仕様の表面だけでは見えてこないのが、開発組織や現場エンジニアが抱えてきたリアルな葛藤です。GitHubのIssueやX(旧Twitter)、エンジニアコミュニティの生の声を集約すると、純粋な技術論を超えた生々しい実態が浮かび上がってきます。

「会社の古いバッチ処理がすべてCommonJSで書かれており、外部APIライブラリをメジャーアップデートしたらESM限定(Pure ESM package)になっていてビルドが全滅した」「なぜ動かないのか丸一日調査したら、tsconfig.jsonとpackage.jsonのモジュール設定の不整合だった」といった手記的なトラブル報告は、現在でも枚挙にいとまがありません。

エンジニア界隈のネットの反応と評判を定点観測すると、特に2020年代前半に起きた「ESM原理主義 vs CJS実用主義」の摩擦に対する疲弊感が強く見受けられます。ライブラリ作者が「CJSサポートを打ち切る」と宣言したことで起きた炎上騒動など、オープンソースエコシステムの過渡期特有の痛みが現場に重い影を落としていたことが分かります。

2026年の現場では、ビルドツールの高度な抽象化によって「普段の開発では違いを意識させない」レベルにまで洗練されたものの、ひとたび設定不全に陥った際に原因究明が長期化するという新たな認知負荷の課題も指摘されています。

一般に知られていない盲点とネットの誤解

ネット上の技術ブログや初学者向けフォーラムには、極端すぎる言説や時代遅れの誤解が散見されます。代表的な2つの誤解を正しく解き明かします。

誤解1:「requireは時代遅れのレガシーだから、既存コードを今すぐ全廃すべき」

これは現場目線では典型的なアンチパターンです。正常に本番稼働しているNode.jsの社内内製ツールや小規模CLIツールにおいて、モジュールシステムを書き換えるだけの目的でリファクタリングを強行することは、テスト工数や思わぬランタイム不整合を招くハイリスクな行為です。互換性が担保されている以上、稼働中のCommonJS資産を無理に壊す必要はありません。

誤解2:「動的import()を使えばrequireと全く同じことができる」

確かにESMでも const mod = await import(path) という動的インポートが存在しますが、これは非同期(Promise)を返します。CommonJSの require() は完全同期で即座に評価されたオブジェクトを返すため、同期関数の内部でその場ですぐに値を取り出すような構造を単純に1対1で置き換えることはできません。全体の非同期設計(async/awaitの伝播)を見直す必要がある点は、見落とされがちな落とし穴です。

【プロの結論】おすすめできる人・慎重になるべき人の判断基準

アーキテクチャ設計やコードの保守性という観点から、モジュール構文の選択において読者がとるべき判断基準は明快です。

【ES Modules(import)を全面採用すべきケース】
・新規に立ち上げるWebフロントエンド、Next.jsやNuxt等のフルスタックフレームワーク環境
・npmへ新規公開するOSSライブラリ(Tree Shakingの恩恵を消費者に提供するため)
・TypeScriptや最新Node.jsを基盤とした新規マイクロサービスの設計

【CommonJS(require)の維持・採用に慎重な妥協が許されるケース】
・数年間安定稼働しており、依存パッケージの更新頻度が低い社内バックエンド・バッチスクリプト
・動的なパス構築や同期的なファイル読み込みロジックが密結合しており、非同期化に伴う影響範囲の特定が極めて困難な既存システム

【require】に関するよくある質問(FAQ)

Q1:ブラウザ環境でそのままrequire()を動かす裏技はありますか?
A1:ブラウザネイティブの機能だけでは動作しません。ブラウザ上でrequireを動作させたい場合、ViteやWebpack、esbuildといったモジュールバンドラーを用いて事前に単一のJSファイルへビルド変換するか、RequireJSのようなAMD規格のローダーを導入する必要があります。しかし現在のモダンWeb開発では、 を利用して標準のimport構文を使用するのが最も確実です。

Q2:Node.jsで突然「require is not defined」が出た時の最も手軽な修正方法は?
A2:プロジェクトの package.json を開き、"type": "module" という行が存在しないか確認してください。もし存在する場合、Node.jsはそのファイルをESMとして扱っています。コード内の require(...) を import ... from ... に書き換えるか、ファイルの拡張子を .js から .cjs(CommonJS明示)に変更することでエラーは解消します。

Q3:PHPのrequireとrequire_onceはどのように使い分けるべきですか?
A3:原則として、関数定義やクラス定義を含む共通ライブラリファイルを読み込む際は、クラスの二重宣言エラーを防ぐために require_once を使用するのが安全です。一方で、呼び出すたびに異なるスコープ変数を注入して描画したいHTMLテンプレート部品などの再利用には、通常の require を用いるのが適切な設計です。

「require」という単語が持つ「客観的な必然性」のニュアンス通り、プログラミングにおけるモジュール読み込みはシステムの屋台骨を支える重要な仕組みです。かつてNode.jsの発展を支えたCommonJSのrequireから、ブラウザとサーバーの境界を越えてWeb標準となったES Modulesのimportへの移行は、Web開発がより安全で高速なエコシステムへと成熟した証拠でもあります。

エラーに遭遇した際は、単にコードの表面を書き換えるのではなく、「いまコードがどの環境(ブラウザかサーバーか)で、どの仕様(CJSかESMか)に基づいて評価されているのか」というレイヤーの構造に目を向けることが解決への最短ルートとなります。歴史的背景と最新の仕様を正しく把握し、堅牢で持続可能なシステム設計に役立ててください。

同じカテゴリの記事

大槻 彩花
デジタルマーケター 大槻 彩花
プロフィールを見る →

スポーツと芸能が交差する話題を担当。大会公式記録と所属先の発表を突き合わせ、数字は必ず出典付きで扱います。

おすすめの関連記事