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

※本サイトにはプロモーション・広告が含まれています。

(最終更新月:2022年3月)

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

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

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

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

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

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

✔YouTube解説動画

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

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

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

筆者プロフィール

筆者プロフィールアイコン

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

【副業】ブログ(月間17万PV)/YouTube/Web・アプリ制作

「プログラミング × ライティング × 営業」の経験を活かし、30後半からのIT系職へシフト。当サイトでは、実際に手を動かせるWebアプリの開発を通じて、プログラミングはもちろん、IT職に必要な情報を提供していきます。

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

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

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

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

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

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

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

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

Djangoとは?

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

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

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

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

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

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

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

  1. Pythonがインストールされている
  2. 仮想環境(Virtualenv)が準備されている
  3. 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 フォルダ名 作成場所

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

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

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

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

cd src

3)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

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

ローカルサーバーを立ち上げてブラウザからアクセスしよう

このままでブラウザからのアクセスはできませんので、サーバーを立ち上げます。

プロジェクトフォルダ「src」内で、下記のコマンドを実行します。

python manage.py runserver

ローカルホストのポート8000へアクセスします。

http://localhost:8000/

こちらが表示されれば完了となります!

まとめ

当記事でお伝えしたことをまとめていきます。

Djangoとは、Python言語をベースとしたWebフレームワークで、様々な企業や開発者に愛用されています。

事前準備としては下記の3つが必要です。

  1. Pythonがインストールできてること
  2. 仮想環境(Virtualenv)の準備ができていること
  3. pipが使えること

Djangoのインストールは仮想環境立ち上げ後に下記のコマンドで完了します。

pip install Django

プロジェクト用のフォルダを作成したら、Djangoプロジェクトを立ち上げましょう。

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

サーバーを立ち上げて、ブラウザからアクセスできれば、無事完了となります。

次回は、Djangoでアプリ開発を進めていくための初期設定について解説していきます。

タイトルとURLをコピーしました