<style>
.markdown-body img:not(.emoji) {
border-radius: 5px;
box-shadow: 1px 1px 5px dimgrey;
}
</style>

Django 安裝
===

## Python 的套件管理工具 pip

Django 是 Python 下的一個擴充套件，Python 提供了一個工具 `pip`，它可以用來安裝與管理 Python 的擴充套件。

### 安裝擴充套件

要利用 `pip` 安裝擴充套件的方式很簡單，語法如下：

pip install 擴充套件名稱

- `pip install` 表示要安裝擴充套件，其後接著欲安裝的套件名稱。在沒有額外指定其他限制條件的情況下，預設會安裝該套件的最新版本。例要安裝 `virtualenv` 的最新版本：

    pip install virtualenv

- 如果要安裝擴充套件的特定版本，可在擴充套件名稱之後，加上 `==版本`，例要安裝 `virtualenv` 的 15.2 版：

    pip install virtualenv==15.2

- 若想限定在某版本以下的最大版號，可以用 `<版本` 來篩選，例要安裝 `virtualenv` 在 16.0 之前的最大版本：

    pip install "virtualenv<16.0"

:::warning
:bulb: **注意雙引號的使用**

<kbd><</kbd> 這個符號在命令提示字元下有特殊的意思，表示要用 <kbd><</kbd> 後面的檔案的內容取代使用者鍵盤來做為標準輸入(重新導向標準輸入的來源，由鍵盤輸入改為檔案)。因此，需要將 `套件名稱<版本` 放在一對雙引號內來告訴命令提示字元這是一個完整的字串，不需要去解釋其中的 <kbd><</kbd> 的意思。
:::
- 日後若開發的網站或工具需要依賴眾多其他 Python 的擴充套件，也可以事先將這些被依賴的擴充套件及其版本限制做成清單，列在一個純文字檔中，然後以下面的方式一次安裝所有依賴的擴充套件：

    pip install -r 套件資訊清單檔案

例：下面這個檔案 `requirements.txt` 的內容是開發某個程式設計教學網站時所用到的擴充套件清單：

    asgiref==3.7.2
    chardet==5.2.0
    Django==4.2.8
    django-excel==0.0.10
    django-photologue==3.17
    django-recaptcha==4.0.0
    django-sortedm2m==3.1.1
    django-sqlprint-middleware==0.1.4
    et-xmlfile==1.1.0
    ExifRead==3.0.0
    jieba==0.42.1
    lml==0.1.0
    lxml==4.9.3
    openpyxl==3.1.2
    Pillow==10.1.0
    psycopg==3.1.15
    pyexcel==0.7.0
    pyexcel-io==0.6.6
    pyexcel-webio==0.1.4
    pyexcel-xls==0.7.0
    pyexcel-xlsx==0.6.0
    Pygments==2.17.2
    pygments-pprint-sql==0.1.0
    python-docx==1.1.0
    pytz==2023.3.post1
    sqlparse==0.4.4
    texttable==1.7.0
    typing_extensions==4.8.0
    whitenoise==6.6.0
    xlrd==2.0.1
    XlsxWriter==3.1.9
    xlwt==1.3.0

要將網站由開發環境移到伺服器時，需在伺服器上也安裝相同的擴充套件，這樣網站才能順利啟動並提提供服務。因此，可以用下面的命令要求 `pip` 由 `requirements.txt` 檔案中讀取套件資訊進行安裝：

    pip install -r requirements.txt

### 列出目前已安裝的擴充套件

pip list

### 解除已安裝的擴充套件

pip uninstall 擴充套件名稱

### 列出已安裝擴充套件的資訊

pip freeze

這個命令會列出已安裝的擴充套件名稱以及版本。通常我們透過 `>` 符號將這個命令的執行結果重新導向輸出到檔案。例：

pip freeze > requirements.txt

- 將已安裝的套件資訊寫到 `requirements.txt` 這個檔案中。

---

## 安裝 Django 網站開發框架

在正式進入 Django 網站開發之前，得先安裝 Django 擴件套件。

:::info

### 電腦教室注意事項

因為電腦教室有安裝還原卡，所有安裝在 C 槽的內容與設定值，重新開機後就失效了。我們需要透過 python 的一個擴充套件，在 D 磁碟機建立一個虛擬的 python 環境，之後安裝套件時，可以將套件皆安裝在 D 磁碟機中，才不需要每次上課都重新安裝一次相關套件。

1. 安裝 virtualenv 套件

    pip install virtualenv

2. 透過 virtualenv 在 D 磁碟機建立一個虛擬的執行環境

    d:
    virtualenv django5

- django5 是自訂的名稱，可以自己命名。但為了方便教學，請統一命名為 django5

之後上課的時候，只要先執行 `D:\django5\Scripts\activate`，就可以載入這個虛擬環境，之後以 pip 安裝的套件，就會安裝在 `D:\django5` 這個資料夾下。

在個人用的電腦上，這個步驟可以跳過。
:::

### 安裝 Django 套件

pip install django

這樣會安裝 Django 的最新版本，在此文件撰寫的當下， Django 的最新版本是 5.0.6 版：

(Django5) D:\>pip install django
Collecting django
  Downloading Django-5.0.6-py3-none-any.whl.metadata (4.1 kB)
Collecting asgiref<4,>=3.7.0 (from django)
  Downloading asgiref-3.8.1-py3-none-any.whl.metadata (9.3 kB)
Collecting sqlparse>=0.3.1 (from django)
  Downloading sqlparse-0.5.0-py3-none-any.whl.metadata (3.9 kB)
Downloading Django-5.0.6-py3-none-any.whl (8.2 MB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 8.2/8.2 MB 1.1 MB/s eta 0:00:00
Downloading asgiref-3.8.1-py3-none-any.whl (23 kB)
Downloading sqlparse-0.5.0-py3-none-any.whl (43 kB)
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 44.0/44.0 kB 1.9 MB/s eta 0:00:00
Installing collected packages: sqlparse, asgiref, django
Successfully installed asgiref-3.8.1 django-5.0.6 sqlparse-0.5.0

(Django5) D:\>

pip 工具在安裝擴充套件時，除了指定安裝的套件之外，若該套件需依賴其他擴充套件的話，pip 也會自動安裝被依賴的套件。由於 Django 5 需依賴 sqlparse 套件，因此 pip 也自動幫我們安裝了 sqlparse 套件。

課程的實作範例皆以 Django 5 為依據，只要安裝的 Django 主要版本號為 5 即可，後面的次版本號沒有太大的差別。

為了保險起見，依前述 pip 安裝套件的說明，也可以用下面的指令來限定 pip 只能安裝 Django 5.x 版：

pip install "django<6.0"

---

## 安裝 Visual Studio Code 編輯器

這個步驟非必要，但選擇一個好用的文字編輯器能協助我們在開發的過程中更加順手。

好用的文字編輯器很多，在學校選修課指導學生利用 Django 開發網站的過程中，發現 Visual Studio Code 安裝完後不太需要進行額外的設定，就已經滿足教學需求。除此之外，它的擴充套件管理也很方便，而且在 Windows、Linux、Mac 都有相對應的版本可以安裝。

### 下載與安裝 Visual Studio Code

請至微軟 Visual Studio Code 的官方網站 https://code.visualstudio.com/ 下載安裝程式，瀏覽該頁面的時候，應該會自動判斷你所使用的作業系統，只要直接按頁面上綠色的 Download 按鈕就好。


下載後請依正常程序執行安裝程式即可。

### 變更界面語系

安裝後會發現 Visual Studio Code 執行時的界面語系為英文，若還是習慣中文界面的話，可以安裝正體中文擴充套件來變更界面語言：

1. 點按左方工具列的第 5 顆按鈕，切換到擴充套件的模式，然後在搜尋文字框輸入「chinese」


2. 點按「Chinese (Tranditional) Language Pack」右下角的「Install」按鈕

3. 安裝後關閉 Visual Studio Code 再重新執行即可套用新的界面語系


### 開啟資料夾

Visual Studio Code 有個特異功能叫做「開啟資料夾」，使用這個功能的時候，Visual Studio Code 會將該資料夾下的檔案及子資料夾的結構呈現在面板上，我們可以在該面板上點選欲編輯或查看的檔案，就可以將該檔案開啟在右方的編輯區。


由於 Django 開發的專案會以資料夾的形式存在，因此開啟資料夾的功能對於之後在專案的各個檔案間切換來說超級實用。

那該如何使用這個功能呢？可以從 Visual Studio Code 的檔案功能表中選擇「開啟資料夾」，或直接以熱鍵 <kbd>Ctrl</kbd>+<kbd>K</kbd> 接著 <kbd>Ctrl</kbd>+<kbd>O</kbd> 來啟用這個功能。


然後 Visual Studio Code 會詢問要開啟哪個資料夾，從對話視窗中選取即可。

另一種方式則是直接先以檔案總管瀏覽到欲開啟的資料夾的上一層，再以滑鼠右鍵點按欲開啟的資料夾，再從快顯功能表選擇「Open with Code」。


---

開發環境及工具都準備好了，可以開始我們的第一個練習專案了。