【初心者向け】Djangoのインストール方法を一から徹底的に解説

ITC運営

3年前

（最終更新月：2022年3月）

✔当記事はこんな疑問をお持ちの方へ向けて書かれています

「Djangoとは？何が便利なの？」

「Djangoのインストール方法が知りたい！」

「Djangoをインストールしたら、どうするの？」

✔当記事を通じてお伝えすること

Djangoとは？
Djangoをインストールするための事前準備
Djangoのインストール方法
インストールできているかを確認する2つの方法
インストールでエラーが出たときの対処法
プロジェクトを作成する方法
サーバーの立ち上げとブラウザからアクセス方法

✔YouTube解説動画

当記事の内容は動画を見ながら進めると、約15分程度で完了します。

動画ならではの情報も解説しているので、記事と一緒にご覧ください。

動画の概要欄には、単元ごとのコードを紹介しているgithubページも載せています。

実践Django Pythonによる本格Webアプリケーション開発 [ 芝田将 ]

created by Rinker

¥3,850 (2024/12/28 17:09:23時点楽天市場調べ-詳細)

筆者プロフィール

【現職】プロダクトマネージャー

【副業】ブログ（月間20万PV）/YouTube/Web・アプリ制作

「プログラミング × ライティング × 営業」の経験を活かし、30後半からのIT系職へシフト。現在はプロダクトマネージャーとして、さまざまな関係者の間に入り奮闘してます。当サイトでは、実際に手を動かせるWebアプリの開発を通じて、プログラミングはもちろん、IT職に必要な情報を提供していきます。

【当ブログで紹介しているサイト】

当サイトチュートリアルで作成したデモ版日報アプリ

Django × Reactで開発したツール系Webアプリ

✔人に見せても恥ずかしくないコードを書こう

「リーダブルコード」は、わかりやすく良いコードの定義を教えてくれる本です。

見るからにきれいなコードの書き方
コードの分割方法
変数や関数の命名規則

エンジニアのスタンダートとすべき基準を一から解説しています。

何回も読むのに値する本なので、ぜひ手にとって読んでみてください。

リーダブルコード ―より良いコードを書くためのシンプルで実践的なテクニック

created by Rinker

Djangoとは？

Djangoとは、Python言語をベースとしたWebフレームワークです。

Djangoは多くの企業、開発者に愛用されているフレームワークでその理由は下記の通りです。

ユーザー認証や管理画面の機能の充実している
Pythonで様々な処理ができる
DRFというAPIツールキットが使える

Djangoを使うことにより、一からコードを書いてサイトを構築するよりも、短い時間、コードで高機能なサイトが作れます。

参考までに別記事にてDjangoで作られている有名なWebサイト10個ご紹介しています↓

Djangoをインストールする前に

Djangoをインストールする前にあなたのパソコンで準備が必要です。

Pythonがインストールされている
仮想環境（Virtualenv）が準備されている
pipがインストールされている

「既に全て揃ってるよ！」という方は次章へお進み下さい。

そうでない方は下記リンクよりそれぞれ準備しましょう。

Pythonのインストール方法はこちら↓

仮想環境の準備方法はこちら↓

仮想環境は絶対に必要と言うわけではありません。

ただ、今後も同パソコン内で複数のアプリ開発をしていく可能性がある場合は、それぞれで独自の環境を構築できるので絶対オススメです。

pipのインストール方法はこちら↓

準備ができましたら、いよいよDjangoをインストールしていきます。

Djangoをインストールする

仮想環境を構築、起動後に、Djangoをインストールしていきます。

pip install Django

ターミナルに下記が表示されれば、成功です。

Successfully installed Django-....

下記のコマンドでインストールしたパッケージを保存しておくこともオススメします。

pip freeze > requirements.txt

動作やバージョン情報を確認する方法

こちらのメッセージが出ていればインストールは無事完了しています。

Successfully installed Django-....

ただ、念の為バージョン情報も含めて確認したい場合は下記の通り進めます。

ターミナルでPythonシェルを立ち上げます。

python

Pythonシェル内で①Djangoライブラリのインポート②バージョン情報を取得します。

>>> import django
>>> django.__version__
'4.0'

「>>>」は入力不要です。3行目の「4.0」がバージョン情報で正しくインストールされていることがわかります。

確認が終わりましたら、下記コマンドでシェルを終了します。

>>> quit()

もしくは「pip freeze」コマンドでインストール済みのライブラリが確認できます。

$ pip freeze
asgiref==3.5.0
backports.zoneinfo==0.2.1
Django==4.0.3
sqlparse==0.4.2

「Django==バージョン情報」が記載されていればインストールは無事完了しています。

もし、正しくインストールができないときは？

バージョン情報の取得時やライブラリのインストール時に下記のようなエラーが出た場合は正しくインストールされていないことがわかります。

>>> import django
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ModuleNotFoundError: No module named 'django'

その場合はアンインストールからの再インストールをまず試みましょう。

アンインストール方法は下記の通りです。

pip uninstall Django

再インストールでも解決できない場合は、下記のページなどで調査、相談してみましょう。

Djangoをインストール後、プロジェクトを立ち上げよう

インストールが完了しましたら、プロジェクトを立ち上げ、ブラウザでアクセスできるまでの解説をしていきます。

まずはプロジェクトの立ち上げです。下記のコマンドによりDjangoプロジェクトが作成できます。

django-admin startproject フォルダ名作成場所

一例としてやってみます。

１）プロジェクトを進めていくためのフォルダを作成します。

.
├── requirements.txt
├── src #新たに作成
└── venv

２）作成したプロジェクトフォルダ（ここでは「src」）へ移動します。

cd src

３）Djangoプロジェクトを立ち上げます。

django-admin startproject main .

こちらの例だと、

フォルダ名「main」というプロジェクトの中心となるフォルダが作成されること
作成場所を「 . 」（ドット）とすることで、今いるフォルダ内に「main」フォルダが作成されること

になります。

フォルダ構成は下記のようになります。

itc
├── requirements.txt
├── src
│   ├── main #作成されました
│   │   ├── __init__.py
│   │   ├── asgi.py
│   │   ├── settings.py
│   │   ├── urls.py
│   │   └── wsgi.py
│   └── manage.py #作成されました
└── venv

以上でプロジェクト立ち上げは成功です！