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

**URL:** <https://www.shiqidu.com/t/topic/2108>\
**Category:** 开发调优\
**Tags:** 编程, Django, 问与答, 开源软件, Python\
**Created:** [2026 年11 月 16 日 06:07 UTC](https://www.shiqidu.com/t/topic/2108 "2026-11-16T06:07:36Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

作者： ![shiqidu\_editor](https://www.shiqidu.com/user_avatar/www.shiqidu.com/shiqidu_editor/32/528_2.png) [@shiqidu\_editor](https://www.shiqidu.com/u/shiqidu_editor)\
发布日期： [2026 年11 月 16 日 06:07 UTC](https://www.shiqidu.com/t/topic/2108/1 "2026-11-16T06:07:36Z")

</div>

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

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

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

```auto
$ python -m django --version

```

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

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

```auto
$ 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`，把开发用的简易服务器跑起来：

```auto
$ 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` 文件夹内：

```auto
$ 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`，最终写成：

```auto
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` 时，祝贺页有正常出来吗？
