想做一套能改数据库的网页后台,Django 官方教程怎么入门?

想搭一套能改数据库记录的网页后台,按 Django 官方「编写你的第一个 Django 应用,第 1 部分」把项目和应用建起来。这不是 Python 标准库怎么用的帖,也不去写成 tomllib 或 TaskGroup 的续篇。

编写你的第一个 Django 应用,第 1 部分 会带你做一个投票应用,规划里有两块:一块给别人查看和投票的公共站点,一块能添加、修改和删除投票的管理站点。第 1 部分还不会碰到改数据库的后台,只把项目、应用和第一条请求响应跑通。页头的文档版本是 6.1,文中也写本教程为 Django 6.1 编写,并写明它支持 Python 3.12 及更高版本。若本机 Django 版本对不上,可以用页面上的版本切换器去看对应教程,或把 Django 更新到较新版本。Python 偏旧的话,文档指向 FAQ 里的版本支持说明。

先确认本机已经装好 Django。官方给的检查命令是:

$ python -m django --version

Windows 上则是 py -m django --version。能打出版本号就说明装上了。若提示 No module named django,说明还没装。教程假定你已经读过「安装 Django」,安装步骤这里不展开。

第一次用 Django,要先创建一个 project。官方把它写成一份项目实例需要的设置集合,包括数据库配置、Django 配置和应用程序配置。引导命令是:

$ django-admin startproject mysite djangotutorial

这会在 djangotutorial 目录里生成名为 mysite 的项目。目录名对 Django 不重要,可以再改成别的。若命令没成功,文档指向 django-admin 的故障排除说明。不要用 django 或 test 这类保留字当项目名,前者会和框架自己冲突,后者会和 Python 内置组件冲突。生成结果里能看到 manage.py,文档把它写成用各种方式管理项目的命令行工具。mysite/ 则是项目真正的 Python 包,之后导入时用的就是这个包名,例如 mysite.urls。包里面还有:空的 __init__.py,用来标明这是一个包。settings.py 是这个项目的设置与配置。urls.py 是 URL 声明,相当于站点的目录。asgi.py 和 wsgi.py 分别是跑在 ASGI、WSGI 兼容服务器上的入口。

然后进入 djangotutorial,把开发用的简易服务器跑起来:

$ python manage.py runserver

Windows 对应的是 py manage.py runserver。成功时会提示 Django version 6.1,开发服务器听在 http://127.0.0.1:8000/,退出用 CONTROL-C。用浏览器打开这个地址,应看到祝贺页和一只正在发射的火箭。页里同时会警告还有未应用的迁移,官方说这一步可以先忽略,稍后再处理数据库。它还反复提醒:这个服务器是用纯 Python 写的轻量服务器,只为让你先进入开发、不必一上来就去配生产环境的 Web 服务器。千万不要放到和生产环境相关的任何地方。runserver 在多数访问请求时会按需重新载入 Python 代码,所以改代码后往往不必频繁重启。但添加新文件这类动作不会触发自动重载,这时要自己动手重启。若要换端口,文档指向 runserver 的参考页。

项目能起来之后,再在 manage.py 所在目录创建应用。官方把项目和应用分开写:应用是做一件具体事的网络程序,比如博客、公共记录库,或这个小型投票程序。项目是一个网站使用的配置和应用的集合。项目可以包含很多个应用,应用也可以被很多个项目使用。教程把投票应用建在 djangotutorial 文件夹内:

$ python manage.py startapp polls

这会生成 polls/,里面有 views.py、models.py、admin.py、apps.py、tests.py,以及 migrations/ 目录。第 1 部分接下来只写一个最基本的视图:打开 polls/views.py,写一个接收 request、返回 HttpResponse("Hello, world. You're at the polls index.") 的 index。要在浏览器里访问它,还得配 URL。文档把这种配置叫做 URLconf,写在应用内部的 urls.py 里。新建 polls/urls.py,引入 path 和当前应用的 views,再写 path("", views.index, name="index")。

下一步是让项目的根 URLconf 把 polls.urls 收进来。改 mysite/urls.py,导入 include 和 path,最终写成:

from django.contrib import admin
from django.urls import include, path

urlpatterns = [
    path("polls/", include("polls.urls")),
    path("admin/", admin.site.urls),
]

path() 至少要有两个参数:route 和 view。遇到 include() 时,Django 会截掉已经匹配到的那一段,把剩下的字符串交给被包含的 URLconf 继续处理。官方写它的设计就是即插即用:投票应用有自己的 URLconf,放在 /polls/、/fun_polls/ 或 /content/polls/ 下都能工作。文档还特别写了,包含其它 URL 配置时应当用 include(),唯一例外是 admin.site.urls,那是默认管理站点预构建的 URLconf。再执行 python manage.py runserver,用浏览器访问 http://localhost:8000/polls/,应能看到刚才那句 Hello world。如果打开的是 http://localhost:8000/ 而不是带 polls/ 的地址,会看不到这条响应。

到这里,第 1 部分就结束了。能改记录的管理后台,以及真正用到数据库,这一部分都还没写到。文末说,了解基本的请求和响应流程后,要开始使用数据库,请阅读教程的第 2 部分。

第一次跑 runserver 时,祝贺页有正常出来吗?