为什么 Django 中的一些 include 需要字符串,而其他一些需要变量名?

Why do some includes in Django need strings, and others variable names?

参考Django Book, chapter 3

from django.conf.urls import patterns, include, url

# Uncomment the next two lines to enable the admin:
# from django.contrib import admin
# admin.autodiscover()

urlpatterns = patterns('',
    # Examples:
    # url(r'^$', 'mysite.views.home', name='home'),
    # url(r'^mysite/', include('mysite.foo.urls')),
    # url(r'^admin/doc/', include('django.contrib.admindocs.urls')),
    # url(r'^admin/', include(admin.site.urls)),
)

是什么决定了为什么一个事物被包含为字符串,而另一个事物被包含为常规变量?为什么 admin.site.urls 而不是 'admin.site.urls'?所有其他 includes 都包含为字符串...我在这里看不到任何逻辑模式。

如果您向 include() 传递一个 url() 实例的列表,那么您不使用字符串(参见 Include() docs and Including other URLconfs docs). In your admin urls example, admin.site.urls refers to a list of url instances. See the get_urls method in the source code(它提供了 url 由 admin.site.urls).

引用的实例
def get_urls(self):
    ...
    # Admin-site-wide views.
    urlpatterns = [
        url(r'^$', wrap(self.index), name='index'),
        url(r'^login/$', self.login, name='login'),
        url(r'^logout/$', wrap(self.logout), name='logout'),
        url(r'^password_change/$', wrap(self.password_change, cacheable=True), name='password_change'),
        url(r'^password_change/done/$', wrap(self.password_change_done, cacheable=True),
            name='password_change_done'),
        url(r'^jsi18n/$', wrap(self.i18n_javascript, cacheable=True), name='jsi18n'),
        url(r'^r/(?P<content_type_id>\d+)/(?P<object_id>.+)/$', wrap(contenttype_views.shortcut),
            name='view_on_site'),
    ]

你是对的,这有点令人困惑。他们在 Django 1.8 中改变了这一点,所以现在他们只支持包含普通变量。

Django 1.8 release note 中阅读更多相关信息。

首先,第一个模式('mysite.views.home' -> 视图函数)在 1.8 中被弃用:它导致了各种麻烦。

至于其余的,它通常都可以。 'mysite.foo.urls' 已解决以将模式包含在模块 mysite.foo.urls 中,但 from mysite.foo import urls as foo_urls; include(foo_urls) 也可以正常工作。基于字符串的导入主要是一个尚未删除的历史产物,但它很方便并且没有任何真正的缺点,因为模块是立即导入的(因此,任何 ImportError 很容易追溯到url 配置)。

admin.site.urls是不同的,因为admin.site.urls不是一个模块,但是site是一个对象而urls是一个属性。因此,admin.site.urls 的基于字符串的导入将不起作用,您必须使用第二种方法。

最后一点,Django Book 开头的警告已经过时了。更多最新的资源,例如官方文档(我知道的最好的官方文档之一),将是可取的。

您必须将带有字符串的路径放入函数 include() 中。但是 admin.site.urls 就像一个字符串,因为在代码的开头,你有一个 import

根据 Django 1.8 文档,include() 可以将模块 模块名称作为参数

https://docs.djangoproject.com/en/1.8/ref/urls/#include

from django.contrib import admin

导入管理模块。因此,它可以直接用作 include 的参数。其他 include() 方法具有命名其他 URLconf 的字符串参数。