注意:創建項目之前先進入虛擬環境
第一步:創建 Django 項目
運行以下命令創建一個名為?myproject
?的 Django 項目:
django-admin startproject myproject
這會生成一個名為?myproject
?的文件夾,結構如下:
myproject/ # 項目容器:僅僅是一個目錄,名字可以隨意修改,不影響 Django 運行。manage.py # 項目管理工具:用于執行各種 Django 命令myproject/ # 這是實際的 Python 包(包含?__init__.py?文件),Django 項目的核心配置都在這里。__init__.py # ?空文件:告訴 Python 這個目錄是一個 Python 包。settings.py # 項目配置:所有全局配置都在此文件urls.py # ?URL 路由配置:定義 URL 路徑與視圖(View)的映射關系。asgi.py # 用于異步服務器部署(如 Daphne),支持 WebSocket。wsgi.py # 用于部署到 WSGI 服務器(如 Gunicorn、uWSGI)。
第二步:項目文件詳細說明
1. 外層?myproject/
?文件夾
- ?項目容器:僅僅是一個目錄,名字可以隨意修改,不影響 Django 運行。
2.?manage.py
- ?項目管理工具:用于執行各種 Django 命令,例如:
python manage.py runserver # 啟動開發服務器 python manage.py startapp myapp # 創建新應用 python manage.py migrate # 應用數據庫遷移
3. 內層?myproject/
?文件夾
這是實際的 Python 包(包含?__init__.py
?文件),Django 項目的核心配置都在這里。
4.?settings.py
- ?項目配置:所有全局配置都在此文件,例如:
INSTALLED_APPS
: 已安裝的應用列表(如 Django 自帶應用和你創建的應用)。DATABASES
: 數據庫配置(默認使用 SQLite)。TIME_ZONE
: 設置時區(如?Asia/Shanghai
)。STATIC_URL
: 靜態文件(CSS/JS/圖片)的 URL 路徑。SECRET_KEY
: 項目的安全密鑰(需保密!)。
5.?urls.py
- ?URL 路由配置:定義 URL 路徑與視圖(View)的映射關系。
from django.urls import path from . import viewsurlpatterns = [path('admin/', admin.site.urls),path('home/', views.home), # 假設你有一個 home 視圖 ]
6.?wsgi.py
?和?asgi.py
- ?服務器部署接口:
wsgi.py
: 用于部署到 WSGI 服務器(如 Gunicorn、uWSGI)。asgi.py
: 用于異步服務器部署(如 Daphne),支持 WebSocket。
7.?__init__.py
- ?空文件:告訴 Python 這個目錄是一個 Python 包。
第三步:運行開發服務器
輸入以下命令啟動開發服務器:
python manage.py runserver
訪問?http://127.0.0.1:8000
?會看到 Django 的歡迎頁面!
下一步:創建應用(App)
Django 項目由多個“應用”組成。例如,你可以創建一個名為?blog
?的應用:
python manage.py startapp blog
應用內會生成?models.py
(定義數據庫模型)、views.py
(處理業務邏輯)、admin.py
(管理后臺配置)等文件。
總結
- ?項目 vs 應用:一個項目包含多個應用(例如?
blog
、users
?等),每個應用負責一個獨立功能。 - ?核心文件:
settings.py
:全局配置。urls.py
:路由定義。manage.py
:命令行工具。