下面讓我們通過(guò)示例來(lái)學(xué)習(xí)惩阶。
通過(guò)這個(gè)教程辐赞，我們將帶著你創(chuàng)建一個(gè)基本的投票應(yīng)用程序括享。

它將由兩部分組成：

• 一個(gè)讓人們查看和投票的公共站點(diǎn)搂根。
• 一個(gè)讓你能添加珍促、修改和刪除投票的管理站點(diǎn)铃辖。

如果未安裝Django請(qǐng)參考我的前一篇文章 安裝Django≈硇穑或者官方安裝文檔

這個(gè)教程是為了 Django 3.1 寫的娇斩，它支持 Python 3.6 和后續(xù)版本。

創(chuàng)建項(xiàng)目

如果這是你第一次使用 Django 的話穴翩，你需要一些初始化設(shè)置犬第。也就是說(shuō)，你需要用一些自動(dòng)生成的代碼配置一個(gè) Django項(xiàng)目（ 即一個(gè) Django 項(xiàng)目實(shí)例需要的設(shè)置項(xiàng)集合芒帕，包括數(shù)據(jù)庫(kù)配置歉嗓、Django 配置和應(yīng)用程序配置。）

打開命令行背蟆，請(qǐng)確保在上一章創(chuàng)建的目錄鉴分，并且激活了虛擬環(huán)境，然后運(yùn)行以下命令：
django-admin startproject mysite
這行代碼將會(huì)在當(dāng)前目錄下創(chuàng)建一個(gè) mysite 目錄带膀。
讓我們看看startproject創(chuàng)建了些什么:

mysite/
    manage.py
    mysite/
        __init__.py
        settings.py
        urls.py
        asgi.py
        wsgi.py

這些目錄和文件的用處是：

• 最外層的 mysite/ 根目錄只是你項(xiàng)目的容器志珍， 根目錄名稱對(duì)Django沒(méi)有影響，你可以將它重命名為任何你喜歡的名稱垛叨。
• manage.py: 一個(gè)讓你用各種方式管理 Django 項(xiàng)目的命令行工具伦糯。
• 里面一層的 mysite/ 目錄包含你的項(xiàng)目，它是一個(gè)純 Python 包。它的名字就是當(dāng)你引用它內(nèi)部任何東西時(shí)需要用到的 Python 包名敛纲。 (比如 mysite.urls).
• mysite/__init__.py：一個(gè)空文件喂击，告訴 Python 這個(gè)目錄應(yīng)該被認(rèn)為是一個(gè) Python 包。
• mysite/settings.py：Django 項(xiàng)目的配置文件淤翔。
• mysite/urls.py：Django 項(xiàng)目的 URL 聲明惭等，就像你網(wǎng)站的“目錄”。
• mysite/asgi.py：作為你的項(xiàng)目的運(yùn)行在 ASGI 兼容的Web服務(wù)器上的入口办铡。
• mysite/wsgi.py：作為你的項(xiàng)目的運(yùn)行在 WSGI 兼容的Web服務(wù)器上的入口辞做。

啟動(dòng)用于開發(fā)的簡(jiǎn)易服務(wù)器

讓我們來(lái)確認(rèn)一下你的 Django 項(xiàng)目是否真的創(chuàng)建成功了。如果你的當(dāng)前目錄不是外層的 mysite 目錄的話寡具，請(qǐng)切換到此目錄秤茅，然后運(yùn)行下面的命令：
python manage.py runserver

你應(yīng)該會(huì)看到如下輸出：

Watching for file changes with StatReloader
Performing system checks...

System check identified no issues (0 silenced).

You have 18 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run 'python manage.py migrate' to apply them.
November 06, 2020 - 15:24:05
Django version 3.1.3, using settings 'mysite.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CTRL-BREAK.

剛剛啟動(dòng)的是 Django 自帶的用于開發(fā)的簡(jiǎn)易服務(wù)器，它是一個(gè)用純 Python 寫的輕量級(jí)的 Web 服務(wù)器童叠。我們將這個(gè)服務(wù)器內(nèi)置在 Django 中是為了讓你能快速的開發(fā)出想要的東西框喳，因?yàn)槟悴恍枰M(jìn)行配置生產(chǎn)級(jí)別的服務(wù)器（比如 Apache）方面的工作，除非你已經(jīng)準(zhǔn)備好投入生產(chǎn)環(huán)境了厦坛。

現(xiàn)在五垮，服務(wù)器正在運(yùn)行，瀏覽器訪問(wèn) http://127.0.0.1:8000/杜秸。你將會(huì)看到一個(gè)“祝賀”頁(yè)面放仗，隨著一只火箭發(fā)射，服務(wù)器已經(jīng)運(yùn)行了撬碟。

更換端口
默認(rèn)情況下runserver命令會(huì)將服務(wù)器設(shè)置為監(jiān)聽(tīng)本機(jī)內(nèi)部 IP 的 8000 端口诞挨。

如果你想更換服務(wù)器的監(jiān)聽(tīng)端口，請(qǐng)使用命令行參數(shù)呢蛤。舉個(gè)例子惶傻，下面的命令會(huì)使服務(wù)器監(jiān)聽(tīng) 8080 端口：
python manage.py runserver 8080

如果你想要修改服務(wù)器監(jiān)聽(tīng)的IP，在端口之前輸入新的其障。比如银室，為了監(jiān)聽(tīng)所有服務(wù)器的公開IP，使用：
python manage.py runserver 0:8000
0 是 0.0.0.0 的簡(jiǎn)寫

會(huì)自動(dòng)重新加載的服務(wù)器 runserver
用于開發(fā)的服務(wù)器在需要的情況下會(huì)對(duì)每一次的訪問(wèn)請(qǐng)求重新載入一遍 Python 代碼励翼。所以你不需要為了讓修改的代碼生效而頻繁的重新啟動(dòng)服務(wù)器蜈敢。然而，一些動(dòng)作抚笔，比如添加新文件扶认，將不會(huì)觸發(fā)自動(dòng)重新加載，這時(shí)你得自己手動(dòng)重啟服務(wù)器殊橙。

創(chuàng)建投票應(yīng)用

現(xiàn)在你的開發(fā)環(huán)境——這個(gè)“項(xiàng)目” ——已經(jīng)配置好了辐宾，你可以開始干活了狱从。

在 Django 中，每一個(gè)應(yīng)用都是一個(gè) Python 包叠纹，并且遵循著相同的約定季研。Django 自帶一個(gè)工具，可以幫你生成應(yīng)用的基礎(chǔ)目錄結(jié)構(gòu)誉察，這樣你就能專心寫代碼与涡，而不是創(chuàng)建目錄了。
項(xiàng)目 VS 應(yīng)用
項(xiàng)目和應(yīng)用有什么區(qū)別持偏？應(yīng)用是一個(gè)專門做某件事的網(wǎng)絡(luò)應(yīng)用程序——比如博客系統(tǒng)驼卖，或者公共記錄的數(shù)據(jù)庫(kù)，或者小型的投票程序鸿秆。項(xiàng)目則是一個(gè)網(wǎng)站使用的配置和應(yīng)用的集合酌畜。項(xiàng)目可以包含很多個(gè)應(yīng)用。應(yīng)用可以被很多個(gè)項(xiàng)目使用卿叽。

請(qǐng)確定你現(xiàn)在處于 manage.py 所在的目錄下桥胞，然后運(yùn)行這行命令來(lái)創(chuàng)建一個(gè)應(yīng)用：
python manage.py startapp polls
這將會(huì)創(chuàng)建一個(gè) polls 目錄，它的目錄結(jié)構(gòu)大致如下：

polls/
    __init__.py
    admin.py
    apps.py
    migrations/
        __init__.py
    models.py
    tests.py
    views.py

這個(gè)目錄結(jié)構(gòu)包括了投票應(yīng)用的全部?jī)?nèi)容考婴。

編寫第一個(gè)視圖

讓我們開始編寫第一個(gè)視圖吧贩虾。打開 polls/views.py，把下面這些 Python 代碼輸入進(jìn)去：

polls/views.py

from django.http import HttpResponse


def index(request):
    return HttpResponse("Hello, 這里是投票應(yīng)用的首頁(yè).")

這是 Django 中最簡(jiǎn)單的視圖沥阱。如果想看見(jiàn)效果缎罢，我們需要將一個(gè) URL 映射到它——這就是我們需要 URLconf 的原因了。

為了創(chuàng)建 URLconf喳钟，請(qǐng)?jiān)?polls 目錄里新建一個(gè) urls.py 文件屁使。
在 polls/urls.py 中在岂，輸入如下代碼：

polls/urls.py

from django.urls import path

from . import views

urlpatterns = [
    path('', views.index, name='index'),
]

下一步是要在根 URLconf 文件中指定我們創(chuàng)建的 polls.urls 模塊奔则。在 mysite/urls.py 文件的 urlpatterns 列表里插入一個(gè) include()， 如下：
mysite/urls.py

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

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

函數(shù) include() 允許引用其它 URLconfs蔽午。每當(dāng) Django 遇到 include() 時(shí)易茬，它會(huì)截?cái)嗯c此項(xiàng)匹配的 URL 的部分，并將剩余的字符串發(fā)送到 URLconf 以供進(jìn)一步處理及老。

你現(xiàn)在把 index 視圖添加進(jìn)了 URLconf抽莱。通過(guò)以下命令驗(yàn)證是否正常工作：
python manage.py runserver

用你的瀏覽器訪問(wèn) http://127.0.0.1:8000/polls/，你應(yīng)該能夠看見(jiàn) "Hello, 這里是投票應(yīng)用的首頁(yè)."

函數(shù) path()具有四個(gè)參數(shù)骄恶，兩個(gè)必須參數(shù)：route 和 view食铐，兩個(gè)可選參數(shù)：kwargs 和 name。

path() 參數(shù): route

route 是一個(gè)匹配 URL 的準(zhǔn)則（類似正則表達(dá)式）僧鲁。當(dāng) Django 響應(yīng)一個(gè)請(qǐng)求時(shí)虐呻，它會(huì)從 urlpatterns 的第一項(xiàng)開始象泵，按順序依次匹配列表中的項(xiàng)，直到找到匹配的項(xiàng)斟叼。

這些準(zhǔn)則不會(huì)匹配 GET 和 POST 參數(shù)或域名偶惠。例如，URLconf 在處理請(qǐng)求 https://www.example.com/myapp/ 時(shí)朗涩，它會(huì)嘗試匹配 myapp/ 忽孽。處理請(qǐng)求 https://www.example.com/myapp/?page=3 時(shí)，也只會(huì)嘗試匹配 myapp/谢床。

path()參數(shù)：view

當(dāng) Django 找到了一個(gè)匹配的準(zhǔn)則兄一，就會(huì)調(diào)用這個(gè)特定的視圖函數(shù)，并傳入一個(gè) HttpRequest 對(duì)象作為第一個(gè)參數(shù)识腿，被“捕獲”的參數(shù)以關(guān)鍵字參數(shù)的形式傳入瘾腰。稍后，我們會(huì)給出一個(gè)例子覆履。

path()參數(shù)：kwargs

任意個(gè)關(guān)鍵字參數(shù)可以作為一個(gè)字典傳遞給目標(biāo)視圖函數(shù)蹋盆。本教程中不會(huì)使用這一特性。

path() 參數(shù)：name

為你的 URL 取名能使你在 Django 的任意地方唯一地引用它硝全，尤其是在模板中栖雾。這個(gè)有用的特性允許你只改一個(gè)文件就能全局地修改某個(gè) URL 模式。