Django プロジェクトの作成方法(Windows)｜startproject と仮想環境

前提

Python と Django が入っていることが前提です。まだの場合は Python3 のインストール (Windows10) と インストール方法(Windows) を先に済ませてください。

python --version
Python 3.12.6

1. フォルダと仮想環境を作る

cd C:\work
mkdir mysite
cd mysite

python -m venv .venv
.venv\Scripts\activate

成功するとプロンプトの先頭に (.venv) が付きます。

(.venv) C:\work\mysite>

PowerShell で このシステムではスクリプトの実行が無効になっているため と出た場合は、そのウィンドウだけ許可します。

Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned

2. Django を入れる

python -m pip install --upgrade pip
python -m pip install django

python -m django --version
5.1.1

pip ではなく python -m pip と書くと、いま有効な Python に確実に入ります。複数バージョンが入っている環境での取り違えを防げます。

3. プロジェクトを作る

django-admin startproject config .

末尾のドットが重要です。付けるかどうかで出来上がる階層が変わります。

ドットを付けた場合の構成です。

C:\work\mysite\
├─ .venv\
├─ manage.py           ← すべての操作の入口
└─ config\
   ├─ __init__.py
   ├─ settings.py      ← 設定
   ├─ urls.py          ← ルーティング
   ├─ asgi.py
   └─ wsgi.py

プロジェクト名を config にしておくと、後からサイト名を変えても import 文を書き換えずに済みます。mysite のようにサービス名を付ける流儀もありますが、アプリ名と紛れやすくなります。

使えない名前

• ハイフンを含む名前（my-site）— Python の識別子として不正
• 数字で始まる名前（2nd）
• Python の予約語（class import test など）
• 既存モジュールと同じ名前（django site json）— import が衝突する

4. 初期化して起動する

python manage.py migrate
python manage.py runserver

Starting development server at http://127.0.0.1:8000/
Quit the server with CTRL-BREAK.

ブラウザで http://127.0.0.1:8000/ を開き、ロケットのイラストと The install worked successfully! が出れば完了です。停止は Ctrl + C です。

migrate を実行すると db.sqlite3 が作られ、管理画面やセッションに必要なテーブルが用意されます。飛ばすと You have 18 unapplied migration(s) という警告が出ます。

5. 日本語向けの設定

# config/settings.py
LANGUAGE_CODE = "ja"
TIME_ZONE = "Asia/Tokyo"
USE_I18N = True
USE_TZ = True                    # DB には UTC で保存し、表示時に変換する

USE_TZ = True のまま運用するのが推奨です。datetime.now() ではなく django.utils.timezone.now() を使ってください。

6. 次にやること

python manage.py startapp myapp        アプリを作る
python manage.py createsuperuser       管理者を作る
python -m pip freeze > requirements.txt  依存を固定する

プロジェクトは器で、実際の機能はアプリとして作ります。作成後は settings.py の INSTALLED_APPS への追加を忘れないでください（アプリケーションの作成方法）。

つまずいたとき

生成されたファイルの役割

settings.py で最初に見るところ

SECRET_KEY = "django-insecure-..."   # 本番では環境変数から読む
DEBUG = True                          # 本番では必ず False
ALLOWED_HOSTS = []                    # DEBUG=False にしたら必須

INSTALLED_APPS = [
    "django.contrib.admin",
    ...
    "myapp",                          # 作ったアプリはここに足す
]

DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.sqlite3",
        "NAME": BASE_DIR / "db.sqlite3",
    }
}

STATIC_URL = "static/"

SECRET_KEY をリポジトリに入れないでください。セッションやパスワードリセットの署名に使われるため、漏れるとログインを偽装される可能性があります。

import os

SECRET_KEY = os.environ["DJANGO_SECRET_KEY"]
DEBUG = os.environ.get("DJANGO_DEBUG", "") == "1"
ALLOWED_HOSTS = os.environ.get("DJANGO_HOSTS", "127.0.0.1").split(",")

Git 管理に入れないもの

# .gitignore
.venv/
__pycache__/
*.pyc
db.sqlite3
.env
/media/
/staticfiles/

仮想環境のフォルダはサイズが大きく、OS ごとに中身が違うため共有しても意味がありません。共有するのは requirements.txt だけにします。詳細は git管理 を参照してください。

関連

• 環境構築とプロジェクト/アプリの作成 — 親カテゴリ
• インストール方法(Windows)
• プロジェクトの作成方法(Mac)
• アプリケーションの作成方法
• 開発用サーバー(Windows)
• 仮想環境の構築(WIndows)