🚀

[Django] 環境構築/インストール

に公開
2026/09/27

🌱 はじめに

Django は、Python で Web アプリケーションを作るためのフレームワークです。
この記事では、Django をインストールし、下記の画面を表示するまでの手順を解説します。

Djangoインストール

動作確認環境

項目 バージョン
OS Linux
Python 3.9
Django 4.1.4

プロジェクトとアプリケーション

Django では、次の 2 つを作成します。

名前 役割 本記事での名前
プロジェクト サイト全体の設定をまとめる入れ物 config
アプリケーション 機能ごとのまとまり。1 つのプロジェクトに複数追加できる Study

🌱 0. 作業ディレクトリの作成

下記のコマンドで作業ディレクトリを作成し、移動します。ディレクトリ名は任意です。以降のコマンドは、すべてこのディレクトリで実行します。

mkdir -p src/Django
cd src/Django
src
└─ Django

🌱 1. ライブラリのインストール

  1. djangoライブラリを下記コマンドでインストールする
    ※記事と同じバージョンを使うため、バージョンを指定しています。
pip install django==4.1.4
  1. Version: 4.1.4がインストールされていることを確認する
    ※行頭の$はプロンプトを表すため、入力は不要です。
$ pip show django
Name: Django
Version: 4.1.4
Summary: A high-level Python web framework that encourages rapid development and clean, pragmatic design.
Home-page: https://www.djangoproject.com/
Author: Django Software Foundation
Author-email: foundation@djangoproject.com
License: BSD-3-Clause
Location: /home/user/.local/lib/python3.9/site-packages
Requires: asgiref, sqlparse
Required-by:

🌱 2. プロジェクトの作成

Django プロジェクトの設定を管理するconfigディレクトリを作成します。

  1. 下記コマンドで、Djangoディレクトリ内にconfigディレクトリを作成する
    ※末尾の.は、カレントディレクトリにプロジェクトを作成する指定です。.を付けないと、ディレクトリが 1 段深くなります。
django-admin startproject config .
  1. configディレクトリの作成後のファイル構成を確認する
src
└─ Django
    ├─ config
    │   ├─ __init__.py
    │   ├─ asgi.py
    │   ├─ settings.py
    │   ├─ urls.py
    │   └─ wsgi.py
    └─ manage.py

🌱 3. アプリケーションの作成

プロジェクト(config)の中に、アプリケーションStudyを作成します。

  1. Studyというアプリケーションを作成するために、下記コマンドを実行する
python manage.py startapp Study
  1. アプリケーションの作成後のファイル構成を確認する
src
└─ Django
    ├─ Study
    │   ├─ __init__.py
    │   ├─ admin.py
    │   ├─ apps.py
    │   ├─ migrations
    │   │   └─ __init__.py
    │   ├─ models.py
    │   ├─ tests.py
    │   └─ views.py
    ├─ config
    │   ├─ __init__.py
    │   ├─ asgi.py
    │   ├─ settings.py
    │   ├─ urls.py
    │   └─ wsgi.py
    └─ manage.py

🌱 4. settings.py の編集

作成したStudyアプリケーションを Django に認識させるため、config/settings.pyのINSTALLED_APPSに、Study/apps.pyのStudyConfigクラスを登録します。

  1. INSTALLED_APPSのリストに'Study.apps.StudyConfig',を追加する
config/settings.py
INSTALLED_APPS = [
+    'Study.apps.StudyConfig',
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
]
  1. 表示言語を日本語、タイムゾーンを日本時間に変更する
config/settings.py
# 日本語
- LANGUAGE_CODE = 'en-us'
+ LANGUAGE_CODE = 'ja'

# 日本時間(Asia/Tokyo)
- TIME_ZONE = 'UTC'
+ TIME_ZONE = 'Asia/Tokyo'

🌱 5. ローカル環境で起動する

  1. python manage.py migrateで、Django が標準で使うデータベースのテーブルを作成する
    ※このときdb.sqlite3が作成されます。実行しないまま起動すると、You have 18 unapplied migration(s).という警告が表示されます。
python manage.py migrate
  1. python manage.py runserverで Django の開発用サーバーを起動する
$ python manage.py runserver
Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).

December 30, 2022 - 01:44:09
Django version 4.1.4, using settings 'config.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.
  1. サーバーを起動したまま、ブラウザの URL 欄にhttp://127.0.0.1:8000/(自分の PC の 8000 番ポート)を入力し、アプリケーションを表示する

Djangoインストール

  1. 確認できたら、ターミナルでCtrl+Cを押してサーバーを停止する

🌱 まとめ

本記事では、次の手順で Django の初期画面を表示しました。

  • pip installで Django をインストールする
  • django-admin startprojectでプロジェクトを、python manage.py startappでアプリケーションを作成する
  • settings.pyでアプリケーションを登録し、言語とタイムゾーンを設定する
  • python manage.py migrateとpython manage.py runserverで起動する
GitHubで編集を提案

Discussion