快速安裝指南

安裝 Python

你可以在你的 shell 中輸入 python 來確定你是否安裝過 Python

安裝 Django

你有三個簡單的方法來安裝 Django：

驗證

若要驗證 Django 是否能被 Python 識別，可以在 shell 中輸入 python。 然後在 Python 提示符下，嘗試匯入 Django：

>>> import django
>>> print(django.get_version())
2.0

建立專案

cd 到一個你想放置你程式碼的目錄，然後執行以下命令：

django-admin startproject mysite

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

這些目錄和檔案的用處是：

• 最外層的:file: mysite/ 根目錄只是你專案的容器， Django 不關心它的名字，你可以將它重新命名為任何你喜歡的名字。
• manage.py: 一個讓你用各種方式管理 Django 專案的命令列工具。你可以閱讀 django-admin and manage.py 獲取所有 manage.py 的細節。
• 裡面一層的 mysite/ 目錄包含你的專案，它是一個純 Python 包。它的名字就是當你引用它內部任何東西時需要用到的 Python 包名。 (比如 mysite.urls
  ).
• mysite/__init__.py：一個空檔案，告訴 Python 這個目錄應該被認為是一個 Python 包。如果你是 Python 初學者，閱讀官方文件中的 更多關於包的知識。
• mysite/settings.py：Django 專案的配置檔案。如果你想知道這個檔案是如何工作的，請檢視 Django settings瞭解細節。
• mysite/urls.py：Django 專案的 URL 宣告，就像你網站的“目錄”。閱讀 URL排程器 文件來獲取更多關於 URL 的內容。
• mysite/wsgi.py：作為你的專案的執行在 WSGI 相容的Web伺服器上的入口。閱讀 如何使用 WSGI 進行部署
   瞭解更多細節。

用於開發的簡易伺服器

讓我們來確認一下你的 Django 專案是否真的建立成功了。如果你的當前目錄不是外層的 mysite 目錄的話，請切換到此目錄，然後執行下面的命令：

$ python manage.py runserver

在，伺服器正在執行，瀏覽器訪問 https://127.0.0.1:8000/。你將會看到一個“祝賀”頁面，隨著一隻火箭發射，伺服器已經運行了。

千萬不要 將這個伺服器用於和生產環境相關的任何地方。這個伺服器只是為了開發而設計的。

更換埠

預設情況下，runserver 命令會將伺服器設定為監聽本機內部 IP 的 8000 埠。

如果你想更換伺服器的監聽埠，請使用命令列引數。舉個例子，下面的命令會使伺服器監聽 8080 埠：

$ python manage.py runserver 8080

建立投票應用

專案 VS 應用

專案和應用有啥區別？應用是一個專門做某件事的網路應用程式——比如部落格系統，或者公共記錄的資料庫，或者簡單的投票程式。專案則是一個網站使用的配置和應用的集合。專案可以包含很多個應用。應用可以被很多個專案使用。

在 Django 中，每一個應用都是一個 Python 包，並且遵循著相同的約定。Django 自帶一個工具，可以幫你生成應用的基礎目錄結構，這樣你就能專心寫程式碼，而不是建立目錄了。

你的應用可以存放在任何 Python path 中定義的路徑。在這個教程中，我們將在你的 manage.py 同級目錄下建立投票應用。這樣它就可以作為頂級模組匯入，而不是 mysite 的子模組。

請確定你現在處於 manage.py 所在的目錄下，然後執行這行命令來建立一個應用：

python manage.py startapp polls

這將會建立一個 polls 目錄，它的目錄結構大致如下：

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

這個目錄結構包括了投票應用的全部內容。