練習 - 建立您的第一個專案

6 分鐘

既然我們已探索 Django 的一些基本概念，讓我們開始建立專案。

使用 Django-admin 建立專案

如先前所強調的，Django 專案是整個專案以及任何我們所建立應用程式的容器。我們來建立專案。

在 Visual Studio Code 的 [終端機] 視窗內，執行下列命令：

django-admin startproject helloproject .

重要

命令結尾的後置句點很重要。它會指示 django-admin 使用目前的資料夾。如果沒有加上這個句點，系統便會建立額外的子目錄。

在執行上述命令之後，新的專案現在應該會在您選擇的目錄之中。在此情況下，您會看到名為 [helloproject] 的新資料夾。

探索專案結構

現在已建立 Django 專案，讓我們來看看結構內包含了什麼內容。

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

系統會在每個 Django 專案中建立命令列公用程式 manage.py。它與 django-admin 具有相同的功能。下列範例顯示當您在專案資料夾內，且想要查看可用的子命令時，可以如何使用它。
```
python manage.py help
```
helloproject 會被視為專案的 Python 套件。
init.py 是一個空白檔案，它的功能是告訴 Python 此目錄應視為套件。
settings.py 包含您所有的設定或組態。
urls.py 包含專案內的 URL。
asgi.py 和 wsgi.py 可視部署的伺服器類型作為網頁伺服器的進入點。

執行專案

既然已安裝 Django，也建立專案和查看專案結構，是時候確認我們的專案是否能正常運作。

在 Visual Studio Code 的 [終端] 視窗中，輸入下列程式碼以啟動伺服器。
```
python manage.py runserver
```
專案會執行系統檢查，並啟動您的開發伺服器。將您開發伺服器的 URL http://localhost:8000 複製並貼入您慣用的瀏覽器中。您應該會看到 Django [Congratulations (恭喜)] 頁面，其中包含一張火箭升空的圖片。
因為我們需要重新設定專案，請暫時停止伺服器。在 [終端] 視窗中，選取 Ctrl+C。

建立 Hello World 應用程式

我們已了解 Django 架構的基本概念，並查看專案的資料夾結構。現在可以建立我們的第一個應用程式！ Hello, world! 應用程式能協助您了解應用程式的建立方式，以及它們如何與 Django 專案協同運作。

在 [終端] 視窗中，執行下列命令以建立應用程式。

python manage.py startapp hello_world

使用此命令，Django 會建立必要的資料夾和檔案，且現在應該會顯示下列結構。

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

向專案註冊應用程式

因為應用程式和專案在 Django 中分開，所以您必須向專案註冊您的應用程式。這藉由更新專案的 settings.py 內變數 INSTALLED_APPS，將參考新增至應用程式設定類別來註冊。在 apps.py 中找到設定類別，與專案的名稱相同。在我們的範例中，類別會命名為 HelloWorldConfig。

在 [helloproject] 內，開啟 settings.py。
尋找應在第 33 行的清單 INSTALLED_APPS。
將以下內容新增至清單結尾的方括弧內 ([ ])：
```
'hello_world.apps.HelloWorldConfig',
```

更新的 INSTALLED_APPS 清單看起來應如下所示：

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'hello_world.apps.HelloWorldConfig',
]

請選取 [檔案]>[全部儲存] 以儲存全部檔案。