← 用語集一覧へ戻る

ルートディレクトリ

Root Directory
development beginner
プロジェクトやフォルダ構造のいちばん上にある起点の階層のこと。文脈によってはOS全体の最上位を指すこともある。
ルートディレクトリ (Root Directory)

概要（サマリー）

ルートディレクトリとは、プロジェクトやフォルダ構造のいちばん上にある起点の階層のことである。文脈によっては、OS全体のファイルシステムの最上位を指すこともある。

ディレクトリの中で、大元となる根っこにあたる場所だと考えるとわかりやすい。AIにコードを作らせていると、「.env ファイルはルートディレクトリに置いてください」のように言われることがよくある。VS Codeなどでプロジェクトを開いたときに、特定のサブフォルダの中ではなく、最初に見える最上位の階層に置くイメージである。

詳細解説

ルートディレクトリは「その構造の出発点」である

フォルダは、入れ子の形で何階層にも分かれていることが多い。
たとえば、プロジェクトの中に src や assets や public があり、その中にさらに細かいフォルダがある、という形である。

このとき、全部をまとめて持っている一番上の階層がルートディレクトリである。
つまりルートディレクトリは、そのプロジェクト全体の出発点であり、下の階層へたどっていく土台になる。

たとえば次のような構成がある。

my-app/
  ├─ src/
  ├─ public/
  ├─ package.json
  └─ .env

この場合、my-app がこのプロジェクトのルートディレクトリである。
src や public は、その下の階層にあるサブディレクトリである。

なぜ「ルートディレクトリに置く」と言われるのか

開発では、「このファイルはルートに置いてください」と言われることがよくある。
これは、そのファイルがプロジェクト全体に関わる設定や入口になっていることが多いからである。

たとえば、次のようなファイルはルートディレクトリに置かれることが多い。

  • .env
  • package.json
  • composer.json
  • README.md
  • .gitignore

これらは特定の一部分だけでなく、プロジェクト全体の設定や管理に関わる。
そのため、深い階層ではなく、一番上の起点に置くのが自然である。

「一番上」とは何に対しての一番上か

ここで少しややこしいのが、「一番上」といっても文脈によって対象が違うことである。

たとえば、次の2つは似ているようで違う。

  • プロジェクトのルートディレクトリ
    そのアプリやサイトの一番上の階層
  • OS全体のルート
    パソコン全体のファイルシステムの一番上

初心者向けの開発会話で「ルートディレクトリ」と言うと、多くの場合はプロジェクトのルートを指す。
つまり「今作業しているアプリの一番上のフォルダ」と考えればよいことが多い。

パス（Path）との関係

ルートディレクトリを理解すると、Path の考え方も分かりやすくなる。
Path は「どこにあるかを示す道順」のようなものである。

たとえば、次のような構成があったとする。

my-app/
  ├─ src/
  │   └─ js/
  │       └─ app.js

この場合、app.js はルートディレクトリ my-app から見て、

src/js/app.js

という位置にある。
つまりルートディレクトリは、「道順を書くときの起点」にもなりやすい。

Web Root とは違うのか

ここはかなり混同しやすい。

  • Root Directory
    プロジェクトや構造全体の一番上
  • Web Root
    Webから直接公開される公開ディレクトリ

たとえば、プロジェクト全体のルートは my-app でも、Webから公開されるのはその中の public フォルダだけ、ということがある。
この場合、my-app はルートディレクトリだが、public はWeb Rootである。

つまり、「一番上」という意味は同じではない。
何の一番上なのかを文脈で見る必要がある。

Home Directory とも違う

もう1つ混ざりやすいのが Home Directory である。

  • Home Directory
    ユーザー自身の作業開始地点
  • Root Directory
    プロジェクトや構造の起点
  • Web Root
    Web公開の起点

たとえば、自分のホームディレクトリの中に ~/projects/my-app/ があり、my-app がプロジェクトのルートディレクトリ、さらにその中の public がWeb Root、ということも普通にある。

どんな場面でよく出てくるか

ルートディレクトリという言葉は、次のような場面でよく出てくる。

設定ファイルを置くとき

.env や package.json などを置く場所として指定されることが多い。

コマンドを実行するとき

npm install や composer install などは、プロジェクトのルートディレクトリで実行する前提になっていることが多い。

AIにコードを依頼するとき

「ルートに README.md を作成して」「ルート直下に .gitignore を置いて」といった指示がよく出る。

相対パスを考えるとき

どこを起点にファイルを参照しているかを理解するうえで重要である。

AI時代にルートディレクトリの理解が重要な理由

AIに開発作業を頼むと、「このファイルをルートに置いて」「ルート直下に作成して」「ルートからの相対パスで指定して」といった表現が非常によく出てくる。
ここでルートディレクトリの意味が分からないと、ファイルを間違った場所に作ってしまいやすい。

たとえば次のような失敗が起こりやすい。

  • .env を src/ の中に入れてしまう
  • package.json を深い階層に作ってしまう
  • AIの指示通りに置いたつもりが、実は場所がずれている
  • コマンドを間違った階層で実行してエラーになる

逆に、ルートディレクトリの感覚があると、AIの指示をかなり正しく読み取れる。
つまりこれは、単なる用語知識ではなく、実務上の迷子防止にもなる。

初心者向けの理解の仕方

最初は、ルートディレクトリを「そのプロジェクト全体を見下ろせる一番上の場所」と覚えるとわかりやすい。
部屋でいえば玄関、木でいえば根元、地図でいえば出発地点のようなものである。

そして、次のように整理すると理解しやすい。

  • ルートディレクトリ = 開発会話では、プロジェクトの一番上
  • サブディレクトリ = その下の各フォルダ
  • Path = そこから目的地までの道順

この3つがつながると、ファイル配置やコマンド実行の意味がかなり見えやすくなる。

より詳しくAIに聞いてみよう

  • ルートディレクトリとは何かを、中学生でもわかるように具体例つきで説明してください。
  • ルートディレクトリと Web Root と Home Directory の違いを、初心者向けに整理してください。
  • .env や package.json がルートディレクトリに置かれる理由を教えてください。
  • プロジェクト構成を見ながら、どこがルートディレクトリか判断するコツを教えてください。
  • AIコーディングでルートディレクトリを理解しておくべき理由を、具体例つきで説明してください。