在本教程中，我們將了解 Django 項目和 Django 應用程序之間的區別，以及如何啟動一個新的 Django 項目。

Django 是構建 Web 應用程序的首選 Python Web 框架。它是一個成熟、功能齊全、靈活且開源的框架，可讓您構建從簡單的 CRUD 應用程序到更復雜的多應用程序項目（如照片共享應用程序）的任何內容。

要求

您不需要先前的知識來設置 Django 項目。但是 Django 是一個 Python 框架，所以要使用它，你應該有使用 Python 的堅實基礎。

在開始之前，請確保您已安裝了 Python 3.6 或更高版本的終端或命令提示符。

大多數 macOS 和 linux 系統默認安裝 Python 3，但如果您使用的是 windows，則需要下載并安裝Python。您可以在Python 官方網站上遵循本指南。

您可以通過打開操作系統的應用程序查找器并搜索Terminal來打開終端，或者在 Windows 上搜索cmd。

設置終端后，就該確認您的 Python 版本了。為此，請鍵入以下命令：

python --version

Python 3.9.7 # My result

如果您沒有得到 Python 3.x 形式的結果，請不要驚慌。有兩種選擇：

• 如果python --version返回 Python 2.x 版本，則需要python3與本教程一起使用。這通常發生在某些 macOS 系統以及某些Linux 發行版（如 Ubuntu）上。嘗試運行以下命令：

python3 --version

Python 3.9.7 # Again, my result

• 如果出現Unknown command錯誤，嘗試運行python3，但仍然出現錯誤，則需要從官方網站下載并安裝 Python。

現在您知道要在終端中運行什么 Python 命令，讓我們深入了解 Django 項目。

什么是 Django 項目？

Django 項目是使 Web 應用程序工作所需的 Python 包。它包含構建站點后端（服務器端開發，用戶看不到的內容）所需的一切。Django 項目的正常功能決定了您如何與數據庫交互、身份驗證、如何檢索數據等等。

您也可以將其視為設置的集合，以及名為應用程序的小型 Python 模塊。我們稍后會討論它們，但作為一個預先概念，應用程序是另一組 Python 文件，用于解決應用程序的特定任務。

通過本文，您將了解 Django 項目的復雜結構。但從一開始我就想讓你知道，一個 Django 項目可以縮小到一個文件，類似于Flask項目。

Minimal Django項目對此進行了快速演示。這是一個包含 23 行代碼的文件，它允許我們帶來 Django “Hello, World!” 生活項目：

import sys

from django.conf import settings
from django.urls import path
from django.core.management import execute_from_command_line
from django.http import HttpResponse

settings.configure(
    DEBUG=True,
    ROOT_URLCONF=sys.modules[__name__],
)


def index(request):
    return HttpResponse('<h1>A minimal Django response!</h1>')


urlpatterns = [
    path(r'', index),
]

if __name__ == '__main__':
    execute_from_command_line(sys.argv)

現在，一個 Django 項目可以走得更遠。一個很好的例子是 Instagram，它有數千個 Django 端點，并且仍然使用這個框架來實現關鍵功能。

如何建立一個 Django 項目

如果以下某些命令看起來很復雜，請不要太擔心。在您創建了幾個項目之后，您就會對它們了如指掌。

首先，你需要知道 Django 是一個外部包。換句話說，它沒有內置在 Python 中，因此您需要使用 PIP 安裝它。

PIP 是 Python 的包管理器，該工具允許您從Python 包索引(PyPI) 安裝 Python 包。

現在，在安裝實際的 Python 包之前，您需要創建一個虛擬環境。為您構建的每個 Django 項目創建一個虛擬環境是一個很好的做法，這樣您就可以跟蹤依賴關系。

也許您在 Django 2.6 項目中的代碼可能不適用于 Django 3.0。虛擬環境可讓您對所擁有的每個項目都有特定的要求。

您可以使用以下命令創建一個名為（或任何您想要的名稱）的虛擬環境：.venv

python -m venv .venv

現在，如果您列出當前目錄中的文件，您將看到一個名為 的新文件夾.venv，其中同時包含獨立的 Python 二進制文件：

$ ls -lah .venv/
Permissions Size User   Date Modified Name
drwxr-xr-x     - daniel 10 nov 23:13  .
drwxr-xr-x     - daniel 10 nov 23:13  ..
drwxr-xr-x     - daniel 10 nov 23:13  bin
drwxr-xr-x     - daniel 10 nov 23:13  include
drwxr-xr-x     - daniel 10 nov 23:13  lib
lrwxrwxrwx     3 daniel 10 nov 23:13  lib64 -> lib
.rw-r--r--    69 daniel 10 nov 23:13  pyvenv.cfg

要激活您的虛擬環境，您需要使用以下命令激活它：

source .venv/bin/activate

這僅適用于 bash shell（適用于 macOS 和 Linux）。如果您使用不同的 shell，您可以查看以下激活venv表：

檢查您的 shell 是否已激活的一種方法是在提示符中查找更改。就我而言，我所看到的如下圖所示。

現在，安裝 Django 包。您可以安裝最新版本或特定版本的 Django：

pip install django # Latest version
pip install django==2.2 # Specific version

啟動項目

安裝 Django 后，要啟動一個新項目，請調用django-admin命令行實用程序并運行：

django-admin startproject <project_name>

值得一提的是，有些名稱是為 Django 保留的——django或者django-admin. 如果您遇到錯誤，請不要擔心。只需嘗試使用不同的項目名稱：

django-admin startproject django
# CommandError: 'django' conflicts with the name of an existing Python module and cannot be used as a project name. Please try another name.
django-admin startproject django-admin
# CommandError: 'django-admin' is not a valid project name. Please make sure the name is a valid identifier.

一種常見的做法是將您的項目命名為config，這有一些好處。首先，它是一個可以在所有項目中保持一致的名稱，其次，“項目”文件夾通常只存儲與配置相關的文件。您可以在官方Django 論壇上閱讀更多內容：

django-admin startproject config

Django項目結構

啟動 Django 項目后，您將看到一個新文件夾，其中包含您選擇的項目名稱，其結構類似于：

.
├── config
│   ├── config
│   │   ├── asgi.py
│   │   ├── __init__.py
│   │   ├── settings.py
│   │   ├── urls.py
│   │   └── wsgi.py
│   └── manage.py
└── .venv

讓我們深入分析每個部分：

• config/是您項目的外部文件夾。這對 Django 無關緊要，因此您實際上可以將其重命名為您想要的任何名稱。
• config/config/是實際的 Django 項目文件夾。它包含您項目的設置文件。
• manage.py是一個 Python 腳本，具有相同的功能，django_admin但使用您項目的設置。
• __init__.py制作config/config一個 Python 包。
• settings.py是您項目的核心文件。您可以添加、修改或刪除變量來更改項目的行為。
• urls.py是定義項目 URL 的文件。
• asgi.py并wsgi.py讓您將項目部署到服務器。

我知道 Django 的項目結構一開始可能有點復雜，但隨著時間的推移，它開始變得有意義。每個文件都有一個目的，開發過程變得非常愉快。

一個常見的快捷方式是省略外部文件夾的創建。這很有用，因為在部署到 Heroku 之類的東西時，您不必修改項目結構：

django-admin startproject <project_name> .

例如，對于您啟動的每個 Django 項目，您可以運行以下命令：

django-admin startproject config .

自己嘗試每個命令，然后決定哪一個最適合您。

為了完成本節，我們將啟動 Django 開發服務器，并檢查項目設置是否成功。

轉到項目的根文件夾（所在manage.py位置）并使用以下命令啟動服務器：

python manage.py runserver

現在，進入你的瀏覽器，輸入localhost:8000/你應該會看到 Django 的默認頁面。

如何設置 Django 應用程序

正如我之前告訴過的，Django 項目與 Django 應用程序不同。

來自官方文檔：“應用程序是做某事的 Web 應用程序”。那是一種特定的功能，例如用戶的應用程序、評論應用程序、聊天應用程序。

您的應用程序的功能定位越多越好。

Django 應用程序是自包含的，這意味著它可以在項目之間重用。這就是為什么您可以安裝一個外部應用程序，例如Django-allauth并在您的項目中使用它，只需將其添加到INSTALLED_AppS變量中即可。

您將花費大部分時間處理應用程序，因為它們會一一構建您項目的所有功能。

從現在開始，您將使用該manage.py實用程序，因此要創建應用程序，請轉到項目的根文件夾并運行以下命令：

python manage.py startapp <app_name>

嘗試盡可能具體地使用您的應用名稱。如果您想創建一個用于將支付與 PayPal 或 Stripe 集成的應用程序，請將其命名為payments：

python manage.py startapp payments

讓我們深入了解 Django 應用程序的結構：

.
├── config
│   ├ ...
├── manage.py
└── payments
    ├── admin.py
    ├── apps.py
    ├── __init__.py
    ├── migrations
    │   └── __init__.py
    ├── models.py
    ├── tests.py
    └── views.py

• payments/是您的應用程序的文件夾。
• admin.py用于將模型注冊到 Django 的管理界面中。
• apps.py定義應用程序配置。
• models.py用于存儲模型，這些模型是我們為存儲和控制數據而創建的對象。
• migrations/是包含應用程序遷移腳本的文件夾。您運行遷移以將我們模型的更改應用到數據庫中。
• tests.py用于測試應用程序。
• views.py是我們定義應用程序視圖的文件。視圖是 Python 可調用的，它接收 HTTP 請求并返回 HTTP 響應。

在您的應用程序中，您可以創建其他文件和文件夾，甚至構建模板，這是 Django 在網頁上動態顯示數據的方式。

命令備忘單

我們在本教程中使用了很多命令，因此這里總結了每個命令的用途。

結論

Django 是一個完整的網絡框架，可讓您構建任何類型的應用程序。設置 Django 項目既快速又簡單，您可以立即開始處理您的項目。

通過本教程，您學會了：

• 創建虛擬環境
• 安裝特定的 Django 版本
• 啟動一個 Django 項目
• 運行 Django 服務器
• 創建一個 Django 應用程序
• 區分 Django 應用程序和 Django 項目