安装 Django

优质
小牛编辑
129浏览
2023-12-01

在這一章,我們會開始建立第一個 Django 專案,並瞭解如何使用虛擬環境。


首先,請開啟終端機,確定現在的位置是在家目錄底下:

我們先建立一個名為 djangogirls 的資料夾

mkdir djangogirls

並切換至剛剛建立的目錄

cd djangogirls

虛擬環境(virtualenv)

在安裝 Django 之前,我們要先建立一個虛擬環境(virtual environment)。

我們可以直接開始安裝 Django,但實務上,大多數人都會搭配使用虛擬環境。使用虛擬環境有許多優點:

  • 你的專案會擁有一個專屬的獨立 Python 環境。
  • 不需要 root 權限,就可以安裝新套件。
  • 方便控管不同版本的套件,不用擔心升級套件會影響到其他專案。
  • 如果需要多人協作或在不同機器上跑同一個專案時,使用虛擬環境也可以確保環境一致性。

創建虛擬環境

在較舊的 Python 版本中,建立處擬環境需要另外安裝。但 Python 3.3 之後已經加入 venv 模組,可以直接使用。

那我們立刻開始,首先要創建一個虛擬環境資料夾 djangogirls_venv

Windows

如果有按照安裝教學,使用 Django Environment 開啟終端機後,輸入以下指令:

C:\Users\YOUR_NAME\djangogirls> python -m venv djangogirls_venv

Linux / OS X

Linux 或 OS X 需要使用 python3 來建立虛擬環境,指令如下:

~/djangogirls$ python3 -m venv djangogirls_venv

切換虛擬環境

虛擬環境建立完成後,我們可以透過 activate 這個 script 來啟動它。

記得未來在安裝新套件,或是要執行 Django 相關指令時,都要先啟動該專案的虛擬環境。

Windows

C:\Users\YOUR_NAME\djangogirls> djangogirls_venv\Scripts\activate

Linux / OS X

~/djangogirls$ source djangogirls_venv/bin/activate

如果無法使用 source 的話,可以用下列指令替代:

~/djangogirls$ . djangogirls_venv/bin/activate

目前的虛擬環境

如果看到前面多了 (虛擬資料夾名稱),則表示已經成功切換至該虛擬環境。

Windows

(djangogirls_venv) C:\Users\YOUR_NAME\djangogirls>

Linux / OS X

(djangogirls_venv) ~/djangogirls$

安裝 Django 1.8 最新版本

開始安裝

Python 3.4 預先安裝了 pip 這個強大的套件管理工具,我們將使用它來安裝 Django:

(djangogirls_venv) ~/djangogirls$ pip install "django<1.9"

這裡需要特別注意,我們使用的指令是 "django<1.9"。這樣一來才可以確保我們安裝的是 Django 1.8 的最新版本

輸入了應該會看到如下的訊息,表示安裝成功

Installing collected packages: django
Successfully installed django-1.8.6

註:如果你看到以 Fatal error in launcher 開頭的輸出,而不是上面的安裝成功訊息,請改用 python -m pip install "django<1.9" 試試看。之後如果在使用 pip 時遇到類似問題,也可以試著在前面加上 python -m

確認安裝成功

最後,讓我們最後來測試一下。

請在虛擬環境下指令輸入 python,進入互動式命令列環境

(djangogirls_venv) ~/djangogirls$ python

輸入以下的指令取得 Django 版本資訊:

>>> import django
>>> django.VERSION
(1, 8, 6, 'final, 0')

如果看見類似上面的訊息,就代表安裝成功囉!