Django自动生成的urlpatterns与官方文档不一致问题咨询

Hey there, I totally get why this would throw you off—seeing two different ways to write URL patterns in Django (tutorials using path() vs. auto-generated files using url()) can be confusing. Let’s break this down clearly:

Why the discrepancy? #

It all boils down to Django version history:

• Prior to Django 2.0, the standard way to define URL patterns was url(), which relies entirely on regular expressions for path matching.
• When Django 2.0 launched, they introduced path(): a simpler, more readable alternative that avoids regex for most common use cases. To maintain backwards compatibility, url() was kept as an alias for the new re_path() function (which is the explicit regex-based method in modern Django).

If your auto-generated urls.py uses url(), it’s either because you’re working with an older Django version (1.x), or the project template hasn’t been updated to prioritize the newer path() syntax.

What’s the difference between the two? #

Let’s break down their use cases with examples:

• path(): The modern, recommended choice for most scenarios. It uses angle brackets <> to capture URL parameters, with built-in converters like <int:pk> (for integers) or <slug:post_title> (for URL-safe strings). No regex required—clean and intuitive!
  Example code:

  from django.urls import path
  from . import views
  
  urlpatterns = [
      path('articles/<int:year>/', views.yearly_archive),
      path('posts/<slug:title>/', views.post_detail),
  ]
  

• url() (or re_path() in 2.0+): For when you need complex, regex-based matching. This is necessary for flexible patterns (like matching a 4-digit year range, or custom string formats). In modern Django, re_path() is preferred over url() because it makes the regex usage explicit.
  Example code:

  from django.urls import re_path  # Use from django.conf.urls import url for older versions
  from . import views
  
  urlpatterns = [
      re_path(r'^articles/(?P<year>[0-9]{4})/$', views.yearly_archive),
      re_path(r'^posts/(?P<title>[a-z0-9-]+)/$', views.post_detail),
  ]
  

Tips for writing your own URL patterns #

1. Confirm your Django version: Run python -m django --version in your terminal. If you’re on 2.0 or newer, stick with path() for most of your URLs—it’s the cleanest approach.
2. Use regex only when needed: Reserve re_path() (or url()) for cases where path()’s built-in converters aren’t enough.
3. Be consistent: Pick one style for your project to keep your codebase tidy, unless you need both for different URL scenarios.

内容的提问来源于stack exchange，提问作者Sebastiaan_L