安裝 Python¶

Django 是一個 Python Web 框架，因此需要在您的機器上安裝 Python。在撰寫本文時，Python 3.13 是最新版本。

若要在您的機器上安裝 Python，請前往 https://www.python.org/downloads/。該網站應該會為您提供最新 Python 版本的下載按鈕。下載可執行安裝程式並執行它。勾選「為所有使用者安裝啟動器（建議）」旁的方塊，然後按一下「立即安裝」。

安裝後，開啟命令提示字元並執行以下命令，檢查 Python 版本是否與您安裝的版本一致

...\> py --version

關於 pip¶

pip 是 Python 的套件管理器，預設包含在 Python 安裝程式中。它可以協助安裝和解除安裝 Python 套件（例如 Django！）。在接下來的安裝中，我們將使用 pip 從命令列安裝 Python 套件。

設定虛擬環境¶

最佳實務是為您建立的每個 Django 專案提供專用環境。在 Python 生態系統中，有很多選項可以管理環境和套件，其中一些在 Python 文件中有所建議。Python 本身附帶 venv 用於管理環境，我們將在本指南中使用它。

若要為您的專案建立虛擬環境，請開啟新的命令提示字元，瀏覽到您想要建立專案的資料夾，然後輸入以下內容

...\> py -m venv project-name

如果 'project-name' 資料夾尚不存在，這將會建立該資料夾並設定虛擬環境。若要啟用環境，請執行

...\> project-name\Scripts\activate.bat

虛擬環境將被啟用，您會在命令提示字元旁看到「(project-name)」來表示。每次您啟動新的命令提示字元時，都需要再次啟用環境。

安裝 Django¶

可以使用虛擬環境中的 pip 輕鬆安裝 Django。

在命令提示字元中，請確保您的虛擬環境已啟用，並執行以下命令

...\> py -m pip install Django

這將下載並安裝最新的 Django 版本。

安裝完成後，您可以透過在命令提示字元中執行 django-admin --version 來驗證您的 Django 安裝。

請參閱 讓您的資料庫開始運作，以取得有關使用 Django 安裝資料庫的資訊。

彩色終端輸出¶

一項提升品質的功能為終端新增了彩色（而不是單色）輸出。在現代終端機中，這應該適用於 CMD 和 PowerShell。如果因某種原因需要停用此功能，請將環境變數 DJANGO_COLORS 設定為 nocolor。

在較舊的 Windows 版本或舊式終端機中，必須安裝 colorama 0.4.6+ 才能啟用語法著色

...\> py -m pip install "colorama >= 0.4.6"

請參閱 語法著色，以取得有關色彩設定的更多資訊。

常見的陷阱¶

• 如果 django-admin 無論給定什麼參數都只顯示說明文字，則可能是 Windows 中的檔案關聯出現問題。檢查在 PATH 中是否設定了多個用於執行 Python 指令碼的環境變數。當安裝了多個 Python 版本時，通常會發生這種情況。

• 如果您是在 Proxy 後面連線到網際網路，執行 py -m pip install Django 命令時可能會出現問題。請在命令提示字元中設定 Proxy 設定的環境變數，如下所示

  ...\> set http_proxy=http://username:password@proxyserver:proxyport
  ...\> set https_proxy=https://username:password@proxyserver:proxyport
  

• 一般而言，Django 假設 I/O 使用 UTF-8 編碼。如果您的系統設定為使用不同的編碼，這可能會導致問題。最新版本的 Python 允許設定 PYTHONUTF8 環境變數，以強制使用 UTF-8 編碼。Windows 10 也提供系統範圍的設定，方法是在系統設定中的語言 ‣ 管理語言設定 ‣ 變更系統地區設定 中勾選 使用 Unicode UTF-8 提供 全球語言支援。