🔹 為什麼要使用虛擬環境？

• 避免套件衝突：不同專案可使用不同的 Python 依賴，避免影響全域環境。
• 方便管理依賴：確保專案的所有開發者都使用相同的套件版本。
• 確保部署順利：確保伺服器上的環境與開發環境一致，減少相容性問題。

🔹 選擇虛擬環境工具：Pip vs Poetry

🔹 環境建置

使用 pip 建立虛擬環境和安裝套件和管理套件

# 建立虛擬環境
python -m venv venv

# 啟動虛擬環境（Windows）
venv\Scripts\activate

# 啟動虛擬環境（macOS / Linux）
source venv/bin/activate

# 確認虛擬環境是否啟動
which python  # Linux/macOS
where python  # Windows

# 更新 pip
pip install --upgrade pip

# 安裝 Django
pip install django

# 安裝其他常用套件
pip install djangorestframework django-environ Pillow

# 將已安裝的套件記錄到 requirements.txt
pip freeze > requirements.txt

# 透過 requirements.txt 重新安裝所有套件
pip install -r requirements.txt

# 解除安裝套件
pip uninstall <套件名稱>

# 升級套件
pip install --upgrade <套件名稱>

# 降級套件（指定舊版本）
pip install <套件名稱>==<舊版本號>

使用 Poetry 建立虛擬環境和安裝套件和管理套件

# 安裝 poetry
pip install poetry

# 設定 Poetry 讓虛擬環境建立在專案目錄中
poetry config virtualenvs.in-project true

# 初始化 Poetry 虛擬環境
poetry init

# 安裝python
poetry env use python3

# 啟動 Poetry 虛擬環境
poetry shell

# 安裝專案相依套件
poetry install

# 安裝 Django
poetry add django

# 安裝其他常用套件
poetry add djangorestframework django-environ Pillow

# 移除套件
poetry remove <套件名稱>

# 升級套件
poetry update <套件名稱>

# 降級套件
poetry add <套件名稱>@<舊版本號>

Poetry 會自動管理依賴，儲存於 pyproject.toml：

[tool.poetry.dependencies]
python = "^3.10"
django = "^4.2"
djangorestframework = "^3.14"

透過 Poetry 重新安裝所有套件

poetry install

🔹 建立 Django 專案與應用程式

建立 Django 專案

# 創建 Django 專案
django-admin startproject myproject
cd myproject

# 檢查專案是否運行正常
python manage.py runserver

建立 Django App

# 創建 App
python manage.py startapp myapp

🔹 settings.py加入已安裝的應用程式

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'rest_framework', # 新增已安裝套件
    'myapp',  # 新增自訂 App
]

🔹 遷移資料庫

python manage.py makemigrations
python manage.py migrate

🔹 建立超級使用者

python manage.py createsuperuser

🔹 啟動開發伺服器

python manage.py runserver

預設伺服器網址

http://127.0.0.1:8000/

登入 Django 管理後台

http://127.0.0.1:8000/admin

🔹 參考文件

• Python 官方文件
• Django 官方文件
• Django REST Framework 官方文件
• Pip 官方文件
• Virtualenv 官方文件
• VSCode Python 擴展文件