建立 2026-09-17 更新 2026-09-17

入門設定

這一頁帶你走完「安裝 Django → 建立 Project → 建立 App → 啟動開發伺服器」的第一輪流程，對應官方教學的 Part 1：Requests and responses。走完這一頁，你就有一個可以在瀏覽器打開的 Django 網站骨架。

安裝 Django

建議先建立虛擬環境（venv 或 uv），再安裝 Django，避免不同專案的套件版本互相干擾：

pip install django

建立 Project

Django 的 Project 是整個網站的容器，裡面放共用設定（settings.py）與總的 URL 對照表；一個 Project 底下可以有多個 App，每個 App 負責一組相關功能（例如部落格、會員系統）。

django-admin startproject mysite

上面的指令會在目前目錄下，建立一個 mysite/ 目錄，裡面才是真正的專案內容。如果不想多一層目錄，直接在目前目錄產生檔案，可以在指令最後加上一個英文句點：

django-admin startproject mysite .

新建立的 Project 大致包含：

mysite/
├── manage.py          # 執行管理指令的入口（runserver、migrate…）
├── mysite/
│   ├── __init__.py
│   ├── settings.py    # 專案設定（資料庫、已安裝 App、時區…）
│   ├── urls.py        # 專案層級的 URL 對照表
│   ├── asgi.py
│   └── wsgi.py

建立 App

python manage.py startapp myapp

建立完 App 之後，必須把它加進 settings.py 裡的 INSTALLED_APPS，Django 才會真正載入這個 App（包含它的 Models、Templates 等）：

# settings.py
INSTALLED_APPS = [
    ...
    "myapp",
]

初學者常見的錯誤，就是寫好了 App 但忘記加進 INSTALLED_APPS，導致 makemigrations、Admin 後台等功能都抓不到這個 App 的內容。

啟動開發伺服器

python manage.py runserver

預設會在 http://127.0.0.1:8000 啟動一個僅供開發使用的伺服器；看到 Django 的歡迎畫面，就代表 Project 建立成功。這個伺服器不可用於正式環境，正式上線的作法請見靜態檔案與上線。

下一步

有了可執行的 Project 之後，接著認識 Django 的核心組成：URLconf、Views、Templates 與 Models。