Djangoのプロジェクト作成を完全解説!django-admin startprojectで始める超初心者向け入門
生徒
「Djangoって聞いたことはあるんですけど、何から始めればいいのか全然わかりません。パソコンもあまり使ったことがなくて……」
先生
「大丈夫です。Djangoは最初の一歩を丁寧に踏めば、初心者でも安心して始められます。まずは“プロジェクト作成”から一緒にやっていきましょう。」
生徒
「プロジェクトって何ですか?難しそうな言葉で不安です。」
先生
「プロジェクトは“Webサイト全体の設計図が入った箱”のようなものです。Djangoではコマンド一つで自動的に用意してくれます。」
1. Djangoのプロジェクト作成とは何か
Djangoのプロジェクト作成とは、Webアプリケーション全体の土台を用意する作業です。Djangoでは、Webサイトを作るために必要な設定ファイルやフォルダ構成を、最初にまとめて自動生成します。これを行うことで、初心者でも迷わず正しい形で開発を始めることができます。
イメージとしては、家を建てる前に基礎工事をするようなものです。基礎がしっかりしていないと、あとから問題が起きやすくなります。Djangoのプロジェクト作成は、その基礎を一瞬で整えてくれる便利な仕組みです。
2. django-adminとは何か
django-admin(ジャンゴ・アドミン)は、Djangoに最初から用意されている専用の操作ツールです。これは「命令を文字で入力してパソコンに作業をお願いする道具」です。普段マウスで操作するのとは違い、キーボードで文字を入力します。
この文字入力を行う場所を「ターミナル」や「コマンドプロンプト」と呼びます。少し黒い画面で怖く見えますが、決められた文字をそのまま入力するだけなので安心してください。
3. django-admin startprojectの基本構文
Djangoのプロジェクトを作成するときに使うのが、django-admin startproject という命令です。これは「新しいDjangoプロジェクトを作ってください」という意味になります。
例えば「myproject」という名前のプロジェクトを作りたい場合、次のように入力します。
django-admin startproject myproject
ここで使われている「myproject」は自由に決めて構いません。Webサイトの名前や、練習用なら「sample」などでも大丈夫です。英語で、短く、わかりやすい名前がおすすめです。
4. プロジェクト作成後にできるフォルダの意味
コマンドを実行すると、新しいフォルダが自動で作られます。このフォルダの中には、Djangoが動くための大切なファイルが入っています。初心者のうちは、すべてを理解する必要はありません。
特に重要なのは「settings.py」という設定ファイルです。これはWebサイト全体のルールブックのような存在です。また「manage.py」は、Djangoを操作するためのリモコンのような役割を持っています。
myproject/
├─ manage.py
└─ myproject/
├─ settings.py
├─ urls.py
└─ __init__.py
5. コマンド入力で失敗しやすいポイント
初心者がよくつまずくポイントとして、文字の打ち間違いがあります。スペルが一文字違うだけで、エラーが表示されます。エラーが出ても焦らず、表示された文字をよく読んでみましょう。
また、全角文字が混ざってしまうこともあります。日本語入力モードのまま英字を打つと、見た目は同じでも中身が違う場合があります。必ず半角英数字で入力してください。
# よくある間違い例(全角スペースが入っている)
django-admin startproject test
6. プロジェクト名の付け方の考え方
Djangoのプロジェクト名は、あとから何度も使う大切な名前です。日本語は使えないため、英語かローマ字で付けます。数字や記号はなるべく使わず、シンプルな名前にしましょう。
例えば、学習用なら「django_practice」、ブログなら「blogproject」など、用途が分かる名前がおすすめです。名前を見ただけで内容が想像できると、後で自分が助かります。
7. 実行結果の確認方法
コマンドを正しく実行できると、エラーは表示されず、何も起きていないように見えます。しかし、フォルダが作成されていれば成功です。エクスプローラーやFinderでフォルダを確認してみましょう。
もしエラーが表示された場合でも、それは「失敗」ではなく「どこが違うか教えてくれているメッセージ」です。エラー文を落ち着いて読むことが、プログラミング上達への近道です。
Command executed successfully
8. 初心者が安心して進めるための心構え
Djangoの環境構築やプロジェクト作成は、最初は難しく感じるかもしれません。しかし、やっていることは「決まった文字を入力して、用意された仕組みを使う」だけです。
一度で覚えようとせず、「こういう流れなんだな」と理解することが大切です。Djangoは多くの人に使われているため、同じところで悩んだ人がたくさんいます。安心して、一歩ずつ進めていきましょう。