さあ、例を交えながら学んでゆきましょう。
\nこのチュートリアルでは、簡単な投票 (poll) アプリケーションの作成に取り組ん でもらいます。
\nPoll アプリケーションは 2 つの部分からなります:
\nユーザが投票したり結果を表示したりできる公開用サイト
投票項目の追加、変更、削除を行うための管理 (admin) サイト
Django は既にインストール済み として説明を進めます。Django がインストールされているかどうか、またどのバージョンがインストールされているかを調べるには、以下のコマンドをシェルプロンプト（先頭の $ は入力待ちを示す記号です）で実行します。
\nLinux / macOS
$ python -m django --version\nWindows
...\\> py -m django --version\nDjango がインストールされていれば、インストールされている Django のバージョンがわかります。もしなければ "No module named django" とエラーが表示されます。
\nこのチュートリアルは Python 3.10 以降をサポートする Django 5.1 用に書かれています。もし Django のバージョンが一致しない場合は、このページの右下にあるバージョンスイッチャーを使って、あなたの Django のバージョンのチュートリアルを参照するか、Django を最新バージョンにアップデートしてください。古いバージョンの Python を使っている場合は、 どのバージョンの Python で Django が使えますか? をチェックして、互換性のあるバージョンの Django を見つけてください。
\n\n初めて Django を使うのなら、最初のセットアップを行う必要があります。通常は、 Django のプロジェクト (project) を構成するコードを自動生成します。プロジェクトとは、データベースの設定や Django 固有のオプション、アプリケーション固有の設定などといった、個々の Django インスタンスの設定を集めたものです。
\nコマンドラインから、コードを保存したいディレクトリに移動し、djangotutorial という名前の新しいディレクトリを作成します。（このディレクトリ名はDjangoには関係なく、任意の名前に変更できます。）
Linux / macOS
$ mkdir djangotutorial\nWindows
...\\> mkdir djangotutorial\n次に、以下のコマンドを実行して新しいDjangoプロジェクトを立ち上げます。
\nLinux / macOS
$ django-admin startproject mysite djangotutorial\nWindows
...\\> django-admin startproject mysite djangotutorial\nこれにより、djangotutorial ディレクトリ内に mysite という名前のプロジェクトが作成されます。もしうまくいかなかった場合は、 django-admin 実行時の問題 を参照してください。
startproject が何を作成したかをみてみましょう:
djangotutorial/\n manage.py\n mysite/\n __init__.py\n settings.py\n urls.py\n asgi.py\n wsgi.py\nファイルはそれぞれ以下のような役割を持っています:
\nmanage.py: Django プロジェクトに対する様々な操作を行うためのコマンドラインユーティリティです｡詳しくは django-admin と manage.py 内の manage.py を参照してください｡
mysite/: これは実際のプロジェクト用のPythonパッケージを含むディレクトリです。このディレクトリの名前は、内部のモジュールやパッケージをインポートするために使用するPythonパッケージ名になります（例: mysite.urls）。
mysite/__init__.py: このディレクトリが Python パッケージであることを Python に知らせるための空のファイルです。Python の初心者は、 Python の公式ドキュメントの more about packages を読んで下さい。
mysite/settings.py: Django プロジェクトの設定ファイルです。 設定の仕組みは Djangoの設定 を参照してください。
mysite/urls.py: Django プロジェクトの URL 宣言、いうなれば Django サイトにおける「目次」に相当します。詳しくは URL ディスパッチャ を参照 してください。
mysite/asgi.py: プロジェクトをサーブするためのASGI互換Webサーバーとのエントリーポイントです。詳細については ASGI とともにデプロイするには を参照してください。
mysite/wsgi.py: プロジェクトをサーブするためのWSGI互換Webサーバーとのエントリーポイントです。詳細は WSGI とともにデプロイするには を参照してください。
Djangoプロジェクトが正常に動作するか確認しましょう。まだであれば、djangotutorial ディレクトリに移動し、以下のコマンドを実行してください。
Linux / macOS
$ python manage.py runserver\nWindows
...\\> py manage.py runserver\nコマンドライン上で下記の出力が確認できるでしょう:
\nPerforming system checks...\n\nSystem check identified no issues (0 silenced).\n\nYou have unapplied migrations; your app may not work properly until they are applied.\nRun 'python manage.py migrate' to apply them.\n\n2026年08月09日 - 15:50:53\nDjango version 5.1, using settings 'mysite.settings'\nStarting development server at http://127.0.0.1:8000/\nQuit the server with CONTROL-C.\n\n
さあ、これでサーバが起動したので、ブラウザで http://127.0.0.1:8000/ にアクセスしてみてください。 "Congratulations!" と表示された、ロケットが離陸しているページが出るはずです。やりましたね！
\nこれで、 Django 開発サーバを起動しました。 Django 開発サーバは Python だけで書かれた軽量な Web サーバです。このサーバは、開発を迅速に行い、運用に適した状態になるまで Apache のような運用サーバの設定をいじらなくても良いようにするためのものです。
\nここでちょっと注意しておきましょう。このサーバは開発中の利用だけを考えて作られています。絶対に運用環境では 使わないでください (筆者たちの専門は Web フレームワークであって、Web サーバではありません)。
\n（サイトを別のポートで提供するには、runserver のリファレンスを参照してください。）
さあ、これで自分用の環境、すなわちプロジェクトが立ち上がり、作業にとりかかる準備ができました。
\nDjango 内に追加する各アプリケーションは、所定の規約に従った Python パッケージで構成されます。 Django には基本的なディレクトリ構造を自動生成するユーティリティが含まれているので、ディレクトリを作ることではなくコードを書くことに集中できます。
\n\nアプリはあなたの Python パス のどこにでも配置できます。このチュートリアルでは、djangotutorial フォルダー内に投票アプリを作成します。
アプリケーションを作るには、 manage.py と同じディレクトリに入って、このコマンドを実行します:
Linux / macOS
$ python manage.py startapp polls\nWindows
...\\> py manage.py startapp polls\nこのコマンドは polls というディレクトリを作成します。中身はこのようになっています:
polls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n views.py\nこのディレクトリ構造が、 poll アプリケーションの全体像です。
\n最初のビューを書いてみましょう。 polls/views.py を開いて、以下の Python コードを書いてください:
polls/views.pyfrom django.http import HttpResponse\n\n\ndef index(request):\n return HttpResponse("Hello, world. You're at the polls index.")\nこれはDjangoにおける最も基本的なビューです。これにブラウザからアクセスするためには、URLにマッピングする必要があります。そのためには、URL設定、略して「URLconf」を定義する必要があります。このURL設定は、各Djangoアプリ内で定義されており、urls.py という名前のPythonファイルです。
polls アプリのURLconfを定義するには、以下の内容で polls/urls.py というファイルを作成します。
polls/urls.pyfrom django.urls import path\n\nfrom . import views\n\nurlpatterns = [\n path("", views.index, name="index"),\n]\nあなたのアプリディレクトリは、次のようになっているはずです。
\npolls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n urls.py\n views.py\n次のステップは、mysite プロジェクトのグローバルなURLconfに、polls.urls で定義されたURLconfを含めることです。そのためには、mysite/urls.py で django.urls.include をインポートし、urlpatterns リストに include() を追加します。つまり、次のようにします。
mysite/urls.pyfrom django.contrib import admin\nfrom django.urls import include, path\n\nurlpatterns = [\n path("polls/", include("polls.urls")),\n path("admin/", admin.site.urls),\n]\npath() 関数には少なくとも2つの引数、route と view が必要です。include() 関数は、他のURLconfを参照するのに使います。Djangoが include() を見つけると、これまでに一致したURLの部分を切り捨て、残りの文字列をインクルードされたURLconfに渡して、さらに処理を続けます。
include() の背景にある考えは、 URL を簡単にプラグ & プレイ可能にすることです。 polls には独自の URLconf (polls/urls.py) を持っているので、 "/polls/" 、 "/fun_polls/" や、 "/content/polls/" といった、どんなパスルート下にも置けて、どこに置いてもきちんと動作します。
これで index ビューを URLconf に紐付けることができました。下記のコマンドを実行して、動作を確認してください:
Linux / macOS
$ python manage.py runserver\nWindows
...\\> py manage.py runserver\nブラウザで http://localhost:8000/polls/ にアクセスすると、 "Hello, world. You're at the polls index." と表示されるのが確認できるでしょう。これはビューの index で定義したものです。
基本的なリクエストとレスポンスのフローに馴染んだら、データベースを使った作業を始めるために チュートリアルその2 を読みましょう。
\n