Djangoプロジェクトのディレクトリ構造を完全解説！初心者でも迷わないフォルダの見方
生徒
「Djangoでプロジェクトを作ったら、フォルダやファイルがたくさん出てきて、どれが何なのか分からなくなりました……」
先生
「最初は誰でもそう感じます。Djangoのディレクトリ構造は、意味を知るととても分かりやすいですよ。」
生徒
「全部覚えないとダメですか？」
先生
「いいえ。まずは全体像と、それぞれの役割をイメージできれば十分です。」
1. Djangoプロジェクトのディレクトリ構造とは
Djangoプロジェクトのディレクトリ構造とは、Webアプリを作るために最初から用意されているフォルダとファイルの並び方のことです。Djangoでは、この構造があらかじめ決まっているため、誰が作っても同じ形からスタートできます。
プログラミング未経験の方は難しく感じるかもしれませんが、考え方はとてもシンプルです。「役割ごとに置き場所が分かれている収納棚」をイメージしてください。設定を書く場所、操作をする場所などが最初から分けられているので、後から探しやすくなっています。
例えば、プロジェクトを作成すると次のような最低限の構成が自動で作られます。
myproject/
├─ manage.py
└─ myproject/
この時点では、中身をすべて理解する必要はありません。「Djangoは、最初から整理された状態で始められる仕組みなんだ」と知っておくだけで十分です。この安心感が、初心者でも学習を続けやすい理由のひとつです。
2. プロジェクト作成直後の全体構成
Djangoでプロジェクトを作成すると、まず一番外側にプロジェクト用のフォルダができます。この中に、操作用ファイルや設定用フォルダが入っています。
myproject/
├─ manage.py
└─ myproject/
├─ __init__.py
├─ settings.py
├─ urls.py
├─ asgi.py
└─ wsgi.py
この形が、Djangoプロジェクトの基本的なディレクトリ構造です。まずは「外側」と「内側」で役割が違う、という点を押さえましょう。
3. manage.pyの役割を理解する
manage.py は、Djangoを操作するための司令塔のようなファイルです。アプリの作成、サーバーの起動、設定の反映など、多くの操作をこのファイル経由で行います。
例えるなら、家電を操作するリモコンのような存在です。直接中身を触ることは少なく、命令を出すために使います。
python manage.py runserver
4. プロジェクト内フォルダの正体
外側のフォルダと同じ名前の内側フォルダが、本当の意味での「プロジェクト本体」です。この中には、Django全体の動きを決める大切な設定ファイルが集まっています。
設定やルールをまとめた場所なので、Webサイト全体の方向性を決める役割を持っています。
5. settings.pyは何をしているファイルか
settings.py は、Djangoプロジェクトのルールブックです。使用するアプリ、言語、時間、セキュリティ設定など、基本的な情報がすべて書かれています。
初心者のうちは、内容をすべて理解する必要はありません。「ここで全体設定をしている」という認識があれば十分です。
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
]
6. urls.pyの役割をやさしく説明
urls.py は、Webサイトの住所と処理内容を結びつける案内板のような存在です。どのURLにアクセスされたら、どの処理を行うかを管理します。
住所録や地図のようなイメージで考えると分かりやすく、Djangoでは必ず登場する重要なファイルです。
urlpatterns = [
path('admin/', admin.site.urls),
]
7. asgi.pyとwsgi.pyは何のためにあるか
asgi.py と wsgi.py は、DjangoとWebサーバーをつなぐための橋渡し役です。少し難しい仕組みですが、初心者の段階では「サーバーと会話するための設定ファイル」と理解すれば問題ありません。
普段の学習では、これらのファイルを直接編集することはほとんどありません。
8. なぜこの構造を理解することが大切なのか
Djangoのディレクトリ構造を理解しておくと、「どこに何を書けばいいのか」が分かるようになります。これは、迷子にならずに開発を進めるための地図を持つようなものです。
最初は全部覚えなくても大丈夫です。フォルダやファイルの役割を少しずつ知ることで、Djangoへの苦手意識は自然と減っていきます。
Djangoエンタープライズ開発の真髄｜大規模システムを支える堅牢なMVTアーキテクチャとセキュリティ設計セミナー
ハローワーク職業訓練講師の実績を持つプロが監修。商用Python開発の「現場の作法」を完全伝授。
Djangoで極める。堅牢な商用アプリケーション設計とMVTモデルの真髄。
本講座では、大規模開発の標準であるDjangoを用いたエンタープライズ開発を学びます。認証、管理画面、ORMなど、Djangoが提供する強力な機能を「なぜ、どう使うのか」という設計的観点から理解し、フルスタック・バックエンドエンジニアとしての地位を確立する60分です。
具体的なワークショップ内容と環境
【つくるもの】
ユーザー認証とデータベース連携を完備した「商用基準の会員制ダッシュボード」を構築。大規模アクセスに耐えうるデータモデリングの基礎を実践します。
【開発環境】
PostgreSQL & Django Debug Toolbarを活用。本番環境を見据えたDB設計と、クエリの最適化（N+1問題の解決）など、テックリード視点の開発を伝授します。
この60分で得られる3つの革新スキル
SQLを意識した効率的なデータ取得。複雑なリレーションをスマートに操る技術をマスターします。
CSRF/XSS対策。プログラミングで最も重要な「ユーザー情報を守る」ための設計思想を習得します。
疎結合で保守性の高いアーキテクチャ。チーム開発で混乱を招かない、綺麗なコードの構造化を学びます。
20名規模を率いる現役PL（プロジェクトリーダー）かつ、ハローワーク等の職業訓練で指導経験を持つ講師陣が、実務で通用するPythonアーキテクチャ設計を体系的に解説。初心者から実務レベルへの「最短到達」を支援します。
