過去バージョン

Django バージョンを確認する 4 つの方法

方法 1: django-admin コマンド

django-admin --version
# 5.2.1

# 仮想環境を有効化していること
source .venv/bin/activate
django-admin --version

方法 2: python -m django

python -m django --version
# 5.2.1

# 複数 Python があってどちらの Django か明確にしたいとき有用
python3.11 -m django --version
python3.12 -m django --version

方法 3: Python シェルで import

>>> import django
>>> django.get_version()
'5.2.1'

>>> django.VERSION
(5, 2, 1, 'final', 0)

# タプルでバージョン比較できる
>>> if django.VERSION >= (4, 2):
...     print('4.2 以上')

# get_version は文字列、VERSION はタプル
# 最終フィールド: 'alpha' / 'beta' / 'rc' / 'final'

方法 4: pip コマンド

# 詳細
pip show django
# Name: Django
# Version: 5.2.1
# Summary: A high-level Python Web framework ...
# Location: .../site-packages
# Requires: asgiref, sqlparse
# Required-by: ...

# 一覧から検索
pip list | grep -i django
# Django                 5.2.1
# django-environ         0.11.2

# JSON で取得
pip list --format=json | python -c "import json,sys; print([p['version'] for p in json.load(sys.stdin) if p['name'].lower()=='django'][0])"

プロジェクト内で確認

稼働中のプロジェクトに対しては manage.py 経由が確実です:

# プロジェクトの仮想環境 + プロジェクトの Django を使う
python manage.py --version
# または
python manage.py shell -c "import django; print(django.get_version())"

# settings.py のロード問題を回避したいとき
python -c "import django; print(django.get_version())"

requirements.txt / pyproject.toml で確認

# requirements.txt
grep -i "^django" requirements.txt
# Django==5.2.1

# pyproject.toml (Poetry)
grep -A1 "\[tool.poetry.dependencies\]" pyproject.toml
# python = "^3.12"
# django = "^5.2"

# Pipfile
grep -A2 "\[packages\]" Pipfile
# django = "==5.2.1"

Django のリリースサイクルと LTS

Django は約 8 か月ごとに新バージョンがリリースされ、2 年に 1 度 LTS（Long-Term Support）版が出ます。LTS は3 年間のサポート期間で、それ以外のリリースは約 16 か月（次の +1 リリース時まで）。

本番運用するプロジェクトはサポート期間が長い LTS を選ぶのが定石です。チュートリアル / 学習なら最新通常版で OK。

Python と Django のバージョン互換

# Python のバージョン確認
python --version
python3 --version

# 古い Python で新しい Django を入れようとすると
# ERROR: Could not find a version that satisfies the requirement django==5.2

依存パッケージの互換性確認

Django プラグイン（django-rest-framework / django-debug-toolbar 等）はDjango のメジャー / マイナーバージョンに連動することが多い。pip check で依存破れを検出:

pip check
# No broken requirements found.   ← OK

# 依存ツリー（pipdeptree）
pip install pipdeptree
pipdeptree -p django
# Django==5.2.1
# ├── asgiref [required: >=3.8.1,<4, installed: 3.8.1]
# └── sqlparse [required: >=0.3.1, installed: 0.5.0]

ロックファイルでの確認

# Poetry
poetry show django
# name        : django
# version     : 5.2.1
# description : A high-level Python Web framework ...

# Pipenv
pipenv graph | head
# Django==5.2.1
#   - asgiref [required: >=3.8.1,<4, installed: 3.8.1]
#   - sqlparse [required: >=0.3.1, installed: 0.5.0]

# uv
uv pip show django

本番サーバで稼働中のバージョンを確認

# 本番サーバに SSH
ssh prod
cd /var/www/myapp

# 仮想環境を有効化
source .venv/bin/activate
python -m django --version

# または直接
.venv/bin/python -c "import django; print(django.get_version())"

# Docker コンテナ内で
docker exec -it myapp python -m django --version

# Kubernetes Pod 内で
kubectl exec -it pod/myapp -- python -m django --version

バージョンアップグレード時の確認

# アップグレード前のバージョン記録
pip freeze > requirements.before.txt

# アップグレード
pip install --upgrade django

# アップグレード後の差分
pip freeze > requirements.after.txt
diff requirements.before.txt requirements.after.txt

# テスト
python manage.py check
python manage.py migrate --dry-run
python manage.py test

# Deprecation Warning を見逃さないために
python -Wd manage.py runserver

古い Django プロジェクトの判定

新しく引き継いだプロジェクトで Django バージョンを推定する手がかり:

FAQ

Q: django-admin --version が「command not found」
A: 仮想環境が有効化されていない可能性大。which django-admin でパスを確認、source .venv/bin/activate。グローバルにも入れたいなら pipx install django。

Q: グローバルとプロジェクトで異なるバージョンがある
A: 仮想環境内では仮想環境の Django が呼ばれます。which python / which django-admin で実体を確認してください。

Q: ベータ版・rc 版が入ってしまった
A: django.VERSION が (5, 2, 0, 'rc', 1) のような形になる。pip install "django>=5.2,<6" --upgrade で安定版にダウングレード。