让我们通过示例来学习。
\n通过这个教程，我们将带着你创建一个基本的投票应用程序。
\n它将由两部分组成：
\n一个让人们查看和投票的公共站点。
一个让你能添加、修改和删除投票的管理站点。
我们假定你已经阅读了 安装 Django。你能知道 Django 已被安装，且安装的是哪个版本，通过在命令提示行输入命令（由 $ 前缀）。
\nLinux / macOS
$ python -m django --version\nWindows
...\\> py -m django --version\n如果这行命令输出了一个版本号，证明你已经安装了此版本的 Django；如果你得到的是一个“No module named django”的错误提示，则表明你还未安装。
\n本教程是为Django 6.0 编写的，它支持Python 3.12及更高版本。如果Django版本不匹配，您可以使用此页面右下角的版本切换器参考Django版本的教程，或将Django更新到最新版本。如果你使用的是旧版本的Python，请查阅 faq-Python version support 以找到兼容的Django版本。
\n\n如果这是你第一次使用 Django 的话，你需要一些初始化设置。也就是说，你需要用一些自动生成的代码配置一个 Django project —— 即一个 Django 项目实例需要的设置项集合，包括数据库配置、Django 配置和应用程序配置。
\n在命令行中，用 cd 命令进入要存储代码的目录中，并运行以下命令来引导创建一个新的Django项目：
Linux / macOS
$ django-admin startproject mysite djangotutorial\nWindows
...\\> django-admin startproject mysite djangotutorial\n这将创建一个目录 djangotutorial，其中包含一个名为 mysite 的项目。目录名对Django来说并不重要；你可以将其重命名为任何你喜欢的名称。如果它不起作用，请参阅 django-admin故障排除。
让我们看看 startproject 创建了些什么：
djangotutorial/\n manage.py\n mysite/\n __init__.py\n settings.py\n urls.py\n asgi.py\n wsgi.py\n这些目录和文件的用处是：
\nmanage.py: 一个让你用各种方式管理 Django 项目的命令行工具。你可以阅读 django-admin 和 manage.py 获取所有 manage.py 的细节。
mysite/: 一个目录，它是你项目的实际 Python 包。它的名称是你需要用来导入其中任何内容的 Python 包名称（例如 mysite.urls）。
mysite/__init__.py：一个空文件，告诉 Python 这个目录应该被认为是一个 Python 包。如果你是 Python 初学者，阅读官方文档中的 更多关于包的知识。
mysite/settings.py：此Django项目的设置与配置。/topject/settings 会告诉你settings文件是如何工作的。
mysite/urls.py：Django 项目的 URL 声明，就像你网站的“目录”。阅读 URL调度器 文档来获取更多关于 URL 的内容。
mysite/asgi.py：作为你的项目的运行在 ASGI 兼容的 Web 服务器上的入口。阅读 如何使用 ASGI 来部署 了解更多细节。
mysite/wsgi.py：作为你的项目的运行在 WSGI 兼容的Web服务器上的入口。阅读 如何使用 WSGI 进行部署 了解更多细节。
让我们验证你的 Django 项目是否正常工作。如果还没有进入 djangotutorial 目录，请先进入该目录，然后运行以下命令：
Linux / macOS
$ python manage.py runserver\nWindows
...\\> py manage.py runserver\n你应该会看到如下输出：
\nPerforming system checks...\n\nSystem check identified no issues (0 silenced).\n\nYou have unapplied migrations; your app may not work properly until they are\napplied. Run 'python manage.py migrate' to apply them.\n\n8月 09, 2026 - 15:50:53\nDjango version 6.0, using settings 'mysite.settings'\nStarting development server at http://127.0.0.1:8000/\nQuit the server with CONTROL-C.\n\nWARNING: This is a development server. Do not use it in a production setting. Use a production WSGI or ASGI server instead.\nFor more information on production servers see: https://docs.djangoproject.com/en/6.0/howto/deployment/\n\n
服务器现在正在运行，通过浏览器访问 http://127.0.0.1:8000/ 。你将看到一个“祝贺”页面，有一只火箭正在发射。你成功了！
\n你已经启动了 Django 开发服务器，这是一个用纯 Python 编写的轻量级网络服务器。我们在 Django 中包含了这个服务器，所以你可以快速开发，而不需要处理配置生产服务器的问题 -- 比如 Apache -- 直到你准备好用于生产。
\n现在是个提醒你的好时机：千万不要 将这个服务器用于和生产环境相关的任何地方。这个服务器只是为了开发而设计的。（我们在网络框架方面是专家，在网络服务器方面并不是。）
\n(若要在一个不同的端口上提供网站服务，请参阅 runserver 参考。)
现在你的开发环境——这个“项目” ——已经配置好了，你可以开始干活了。
\n在 Django 中，每一个应用都是一个 Python 包，并且遵循着相同的约定。Django 自带一个工具，可以帮你生成应用的基础目录结构，这样你就能专心写代码，而不是创建目录了。
\n\n你的应用程序可以位于 Python 路径 中的任何位置。在本教程中，我们将在 djangotutorial 文件夹内创建我们的 poll 应用程序。
请确定你现在处于 manage.py 所在的目录下，然后运行这行命令来创建一个应用：
Linux / macOS
$ python manage.py startapp polls\nWindows
...\\> py manage.py startapp polls\n这将创建一个名为 polls 的目录，其布局如下：
polls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n views.py\n这个目录结构包括了投票应用的全部内容。
\n让我们开始编写第一个视图吧。打开 polls/views.py，把下面这些 Python 代码输入进去：
polls/views.pyfrom django.http import HttpResponse\n\n\ndef index(request):\n return HttpResponse("Hello, world. You're at the polls index.")\n这是在 Django 中最基本的视图。要在浏览器中访问它，我们需要将其映射到一个 URL——为此我们需要定义一个 URL 配置，简称为 "URLconf"。这些 URL 配置是在每个 Django 应用程序内部定义的，它们是名为 urls.py 的 Python 文件。
要为 polls 应用定义一个 URLconf，创建一个名为 polls/urls.py 的文件，并包含以下内容：
polls/urls.pyfrom django.urls import path\n\nfrom . import views\n\nurlpatterns = [\n path("", views.index, name="index"),\n]\n你的应用目录现在应该如下所示：
\npolls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n urls.py\n views.py\n下一步是将 mysite 项目中的根 URLconf 配置为包含 polls.urls 中定义的 URLconf。为此，你需要在 mysite/urls.py 中导入 django.urls.include，并在 urlpatterns 列表中插入一个 include() 调用，最终代码如下：
mysite/urls.pyfrom django.contrib import admin\nfrom django.urls import include, path\n\nurlpatterns = [\n path("polls/", include("polls.urls")),\n path("admin/", admin.site.urls),\n]\npath() 函数至少需要两个参数：route 和 view。include() 函数允许引用其他 URLconfs。每当 Django 遇到 include() 时，它会截断 URL 中匹配到该点的部分，并将剩余的字符串发送到包含的 URLconf 以进行进一步处理。
我们设计 include() 的理念是使其可以即插即用。因为投票应用有它自己的 URLconf( polls/urls.py )，他们能够被放在 "/polls/" ， "/fun_polls/" ，"/content/polls/"，或者其他任何路径下，这个应用都能够正常工作。
你现在把 index 视图添加进了 URLconf。通过以下命令验证是否正常工作：
Linux / macOS
$ python manage.py runserver\nWindows
...\\> py manage.py runserver\n用你的浏览器访问 http://localhost:8000/polls/，你应该能够看见 "Hello, world. You're at the polls index." ，这是你在 index 视图中定义的。
当你了解了基本的请求和响应流程后，请阅读 教程的第 2 部分 开始使用数据库.
\n