如何安裝 Django¶
本文將引導您開始使用 Django。
安裝 Python¶
Django 是一個 Python 網頁框架。詳情請參閱 我可以使用哪個 Python 版本搭配 Django？。
請至 https://www.python.org/downloads/ 或使用作業系統的套件管理工具取得最新版本的 Python。
Windows 上的 Python
如果您是剛開始使用 Django 且使用 Windows，您可能會發現 如何在 Windows 上安裝 Django 很有用。
安裝 Apache 和 mod_wsgi¶
如果您只是想試用 Django，請跳到下一節；Django 包含一個輕量級的網頁伺服器，您可以用於測試，所以您不需要設定 Apache，直到您準備好在生產環境中部署 Django 時。
如果您想在生產網站上使用 Django，請使用 Apache 與 mod_wsgi。mod_wsgi 以兩種模式之一運作：嵌入模式或守護程序模式。在嵌入模式中，mod_wsgi 類似於 mod_perl – 它將 Python 嵌入到 Apache 中，並在伺服器啟動時將 Python 程式碼載入記憶體。程式碼會在 Apache 程序的整個生命週期中保留在記憶體中，這比其他伺服器配置帶來顯著的效能提升。在守護程序模式中，mod_wsgi 會產生一個獨立的守護程序處理請求。守護程序可以使用與網頁伺服器不同的使用者執行，可能提高安全性。守護程序可以在不重新啟動整個 Apache 網頁伺服器的情況下重新啟動，可能使更新程式碼庫更順暢。請參閱 mod_wsgi 文件以決定哪種模式適合您的設定。請確保您已安裝 Apache 並啟用 mod_wsgi 模組。Django 可與任何支援 mod_wsgi 的 Apache 版本搭配使用。
請參閱 如何將 Django 與 mod_wsgi 搭配使用 以取得有關如何在安裝 mod_wsgi 後設定 mod_wsgi 的資訊。
如果您因某些原因無法使用 mod_wsgi，請別擔心：Django 支援許多其他部署選項。其中一種是 uWSGI；它與 nginx 搭配使用效果很好。此外，Django 遵循 WSGI 規格 (PEP 3333)，這使其可以在各種伺服器平台上運行。
讓您的資料庫運作¶
如果您計劃使用 Django 的資料庫 API 功能，您需要確保資料庫伺服器正在運行。Django 支援許多不同的資料庫伺服器，並正式支援 PostgreSQL、MariaDB、MySQL、Oracle 和 SQLite。
如果您正在開發一個小型專案或不打算在生產環境中部署的專案，SQLite 通常是最好的選擇，因為它不需要運行單獨的伺服器。但是，SQLite 與其他資料庫有許多差異，因此如果您正在處理重要的事情，建議您使用與您計劃在生產環境中使用的相同的資料庫進行開發。
除了官方支援的資料庫之外，還有 第三方提供的後端，讓您可以使用其他資料庫與 Django。
若要使用 SQLite 以外的其他資料庫，您需要確保已安裝適當的 Python 資料庫綁定
如果您正在使用 PostgreSQL，您需要 psycopg 或 psycopg2 套件。請參閱 PostgreSQL 說明 以取得更多詳細資訊。
如果您正在使用 MySQL 或 MariaDB，您需要一個 DB API 驅動程式，例如
mysqlclient。請參閱 MySQL 後端的說明 以取得詳細資訊。如果您正在使用 SQLite，您可能需要閱讀 SQLite 後端說明。
如果您正在使用 Oracle，您需要安裝 oracledb，但請閱讀 Oracle 後端的說明 以取得有關 Oracle 和
oracledb的支援版本的詳細資訊。如果您正在使用非官方的第三方後端，請查閱提供的文件以了解任何其他要求。
並確保 DATABASES 字典的 'default' 項目中的以下鍵值與您的資料庫連線設定相符
ENGINE–'django.db.backends.sqlite3'、'django.db.backends.postgresql'、'django.db.backends.mysql'或'django.db.backends.oracle'其中之一。其他後端也可用。NAME– 您的資料庫名稱。如果您正在使用 SQLite，則資料庫將是您電腦上的檔案。在這種情況下，NAME應該是完整絕對路徑，包括該檔案的檔名。您不需要事先建立任何東西；資料庫檔案會在需要時自動建立。預設值BASE_DIR / 'db.sqlite3'會將檔案儲存在您的專案目錄中。
對於 SQLite 以外的資料庫
如果您沒有使用 SQLite 作為您的資料庫，則必須新增其他設定，例如 USER、PASSWORD 和 HOST。如需更多詳細資訊，請參閱 DATABASES 的參考文件。
此外，請確保您已在此時建立資料庫。使用資料庫互動式提示中的「CREATE DATABASE database_name;」執行此動作。
如果您計畫使用 Django 的 manage.py migrate 命令來自動為您的模型建立資料庫表格（在首次安裝 Django 並建立專案後），您需要確保 Django 有權限在您使用的資料庫中建立和變更表格；如果您計畫手動建立表格，您可以授與 Django SELECT、INSERT、UPDATE 和 DELETE 權限。在使用這些權限建立資料庫使用者後，您將在專案的設定檔中指定詳細資訊，請參閱 DATABASES 以取得詳細資訊。
如果您正在使用 Django 的 測試框架 來測試資料庫查詢，Django 將需要建立測試資料庫的權限。
安裝 Django 程式碼¶
安裝指示會因您是安裝特定於發行版的套件、下載最新的官方發行版還是取得最新的開發版本而略有不同。
使用 pip 安裝官方發行版¶
這是安裝 Django 的建議方法。
安裝 pip。最簡單的方法是使用 獨立 pip 安裝程式。如果您的發行版已安裝
pip，您可能需要更新它（如果它已過時）。如果它已過時，您會知道，因為安裝將無法運作。請參考 venv。這個工具提供隔離的 Python 環境，比起在系統層級安裝套件更為實用。它也允許您在沒有管理員權限的情況下安裝套件。貢獻教學 將逐步說明如何建立虛擬環境。
在您建立並啟用虛擬環境後，輸入指令
$ python -m pip install Django
...\> py -m pip install Django
安裝特定發行版本的套件¶
請查看 特定發行版本的注意事項，以了解您的平台/發行版本是否提供官方的 Django 套件/安裝程式。發行版本提供的套件通常允許自動安裝相依性並支援升級路徑；然而，這些套件很少包含 Django 的最新版本。
安裝開發版本¶
追蹤 Django 開發
如果您決定使用 Django 的最新開發版本，您會需要密切關注 開發時間軸，並且您會需要留意 即將發行的版本說明。這將幫助您掌握任何您可能想使用的新功能，以及當您更新 Django 版本時，您需要對程式碼做出的任何變更。（對於穩定版本，任何必要的變更都會在版本說明中記錄。）
如果您希望能夠偶爾使用最新的錯誤修正和改進來更新您的 Django 程式碼，請按照以下指示操作
請確保您已安裝 Git，並且您可以從 shell 執行其指令。（在 shell 提示符號輸入
git help以測試。）像這樣檢出 Django 的主要開發分支
$ git clone https://github.com/django/django.git
...\> git clone https://github.com/django/django.git這將在您目前所在的目錄中建立一個
django目錄。請確保 Python 直譯器可以載入 Django 的程式碼。最方便的做法是使用虛擬環境和 pip。貢獻教學 將逐步說明如何建立虛擬環境。
在設定並啟用虛擬環境後，執行以下指令
$ python -m pip install -e django/
...\> py -m pip install -e django\這將使 Django 的程式碼可匯入，並使
django-admin公用程式指令可用。換句話說，您都設定好了！
當您想要更新您的 Django 原始碼副本時，請從 django 目錄中執行指令 git pull。當您這樣做時，Git 將下載任何變更。
