この記事の要点

urls.py の urlpatterns リストで URL と view の対応を定義する path("books/<int:id>/", views.detail) でパスコンバータ（int / str / slug / uuid）を指定 正規表現が必要なら re_path(r"^books/(?P<id>\d+)/$", ...) name="book_detail" を付けると reverse("book_detail") や {% url "book_detail" %} で URL 逆引き可能 include() でアプリごとの urls.py を分割し、app_name = "books" で名前空間化 名前空間ありの逆引きは {% url "books:detail" id=1 %}

最小構成

# myproject/urls.py
from django.contrib import admin
from django.urls import path
from myapp import views

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', views.index, name='home'),                # /
    path('about/', views.about, name='about'),          # /about/
    path('books/', views.book_list, name='book_list'),  # /books/
    path('books/<int:id>/', views.book_detail, name='book_detail'),  # /books/123/
]

# myapp/views.py
from django.shortcuts import render, get_object_or_404
from .models import Book

def index(request):
    return render(request, 'index.html')

def book_list(request):
    return render(request, 'book_list.html', {'books': Book.objects.all()})

def book_detail(request, id):
    book = get_object_or_404(Book, pk=id)
    return render(request, 'book_detail.html', {'book': book})

パスコンバータ

コンバータ	マッチ	view に渡る型	例
str（default）	/ 以外の文字列	str	<str:name>
int	0 以上の整数	int	<int:id>
slug	英数字・ハイフン・アンダースコア	str	<slug:slug>
uuid	UUID 形式	UUID	<uuid:id>
path	/ を含む文字列全部	str	<path:filepath>

path() と re_path() の使い分け

from django.urls import path, re_path
from . import views

urlpatterns = [
    # path: シンプル・読みやすい（推奨）
    path('articles/<int:year>/<int:month>/', views.month_archive),

    # re_path: 正規表現が必要な場合のみ
    re_path(r'^articles/(?P<year>[0-9]{4})/(?P<month>[0-9]{2})/$', views.month_archive),

    # 例: 4桁固定の年・2桁固定の月
    re_path(r'^reports/(?P<year>\d{4})/(?P<month>\d{2})/$', views.report),
]

path が使えるなら常に path を選ぶ。re_path は正規表現の細かい制限が必要なときだけ。

include() でアプリ毎に分割

プロジェクトが大きくなったら、アプリ単位で urls.py を分けます:

# myproject/urls.py
from django.contrib import admin
from django.urls import path, include

urlpatterns = [
    path('admin/', admin.site.urls),
    path('', include('home.urls')),
    path('books/', include('books.urls')),
    path('users/', include('users.urls')),
    path('api/v1/', include('api.urls')),
]

# books/urls.py
from django.urls import path
from . import views

app_name = 'books'   # 名前空間

urlpatterns = [
    path('', views.book_list, name='list'),
    path('<int:id>/', views.book_detail, name='detail'),
    path('<int:id>/edit/', views.book_edit, name='edit'),
    path('new/', views.book_new, name='new'),
]

name による URL 逆引き

URL を文字列でハードコードせず、name で参照することでURL 変更時の影響を最小化できます:

# views.py
from django.shortcuts import redirect
from django.urls import reverse

def book_create(request):
    if request.method == 'POST':
        book = Book.objects.create(...)
        # ハードコード: ✗
        # return redirect('/books/' + str(book.id) + '/')

        # 名前空間 + name: ○
        return redirect('books:detail', id=book.id)

        # reverse でも書ける
        return redirect(reverse('books:detail', kwargs={'id': book.id}))

{# テンプレートから #}
<a href="{% url 'books:detail' id=book.id %}">{{ book.title }}</a>
<a href="{% url 'books:edit' id=book.id %}">編集</a>
<a href="{% url 'books:new' %}">新規作成</a>
<a href="{% url 'home' %}">ホーム</a>

名前空間（namespace）

app_name による名前空間で、複数アプリの URL 名衝突を防げます:

# books/urls.py
app_name = 'books'
urlpatterns = [path('', views.list, name='list')]

# users/urls.py
app_name = 'users'
urlpatterns = [path('', views.list, name='list')]

両方とも name='list' ですが、テンプレートでは {% url 'books:list' %} / {% url 'users:list' %} と区別できます。

クエリパラメータと URL 引数

# /search/?q=python&page=2 の場合

# URL ルーティング: クエリ部分は urls.py に書かない
urlpatterns = [
    path('search/', views.search, name='search'),
]

# view 側で request.GET から取得
def search(request):
    query = request.GET.get('q', '')
    page = int(request.GET.get('page', 1))
    ...

クラスベースビューと URLconf

# views.py
from django.views.generic import ListView, DetailView
from .models import Book

class BookListView(ListView):
    model = Book
    template_name = 'books/list.html'

class BookDetailView(DetailView):
    model = Book
    template_name = 'books/detail.html'
    pk_url_kwarg = 'id'

# books/urls.py
from .views import BookListView, BookDetailView

urlpatterns = [
    path('', BookListView.as_view(), name='list'),
    path('<int:id>/', BookDetailView.as_view(), name='detail'),
]

カスタムコンバータ

独自のパス変換ロジックを書きたい場合:

# converters.py
class YearMonthConverter:
    regex = r'\d{4}-\d{2}'

    def to_python(self, value):
        year, month = value.split('-')
        return {'year': int(year), 'month': int(month)}

    def to_url(self, value):
        return f"{value['year']}-{value['month']:02d}"

# urls.py
from django.urls import path, register_converter
from . import converters, views

register_converter(converters.YearMonthConverter, 'ym')

urlpatterns = [
    path('archive/<ym:date>/', views.archive),
    # /archive/2026-05/ にマッチ
]

URL 解決順

Django は urlpatterns の上から順にマッチを試みて、最初にマッチしたものを使います:

# 順番が大事！
urlpatterns = [
    path('books/new/', views.book_new),         # ← /books/new/ はこっち
    path('books/<int:id>/', views.book_detail),  # 後ろなので /books/new/ には食われない
]

# 逆だと: /books/new/ → <int:id> はマッチしないので OK だが、
# /books/123/ より具体的なパスは先に書く習慣を

FAQ

Q: 末尾スラッシュは付ける？付けない？
A: Django のデフォルトは付ける。APPEND_SLASH = True でスラッシュ無しアクセス時に自動でリダイレクト。

Q: 404 / 500 のカスタムページ
A: ルート urls.py に handler404 = 'myapp.views.custom_404' を定義。テンプレートは templates/404.html。

Q: URL リストを動的に作りたい
A: 通常は不要。複数同じパターンを生成するなら for ループで urlpatterns.extend([...])。