Låt oss lära oss genom exempel.
\nI den här handledningen går vi igenom hur du skapar en grundläggande poll-applikation.
\nDen kommer att bestå av två delar:
\nEn publik webbplats som låter människor se omröstningar och rösta i dem.
En administratörswebbplats där du kan lägga till, ändra och ta bort omröstningar.
Vi antar att du redan har Django installerat. Du kan se om Django är installerat och vilken version det är genom att köra följande kommando i en shell-prompt (anges med prefixet $):
\nLinux / macOS
$ python -m django --version\nWindows
...\\> py -m django --version\nOm Django är installerat bör du se versionen av din installation. Om den inte är det får du ett felmeddelande som säger ”Ingen modul med namnet django”.
\nDenna handledning är skriven för Django 5.2, som stöder Python 3.10 och senare. Om Django-versionen inte matchar kan du hänvisa till handledningen för din version av Django genom att använda versionsomkopplaren längst ner till höger på denna sida, eller uppdatera Django till den senaste versionen. Om du använder en äldre version av Python, kontrollera Vilken Python-version kan jag använda med Django? för att hitta en kompatibel version av Django.
\n\nOm det här är första gången du använder Django måste du ta hand om en del inledande inställningar. Du måste nämligen autogenerera en del kod som upprättar ett Django project - en samling inställningar för en instans av Django, inklusive databaskonfiguration, Django-specifika alternativ och applikationsspecifika inställningar.
\nFrån kommandoraden, cd till en katalog där du vill lagra din kod och skapa en ny katalog med namnet djangotutorial. (Detta katalognamn spelar ingen roll för Django; du kan byta namn på det till vad du vill)
Linux / macOS
$ mkdir djangotutorial\nWindows
...\\> mkdir djangotutorial\nKör sedan följande kommando för att starta upp ett nytt Django-projekt:
\nLinux / macOS
$ django-admin startproject mysite djangotutorial\nWindows
...\\> django-admin startproject mysite djangotutorial\nDetta kommer att skapa ett projekt som heter mysite i katalogen djangotutorial. Om det inte fungerade, se Problem med att köra django-admin.
Låt oss titta på vad startproject skapade:
djangotutorial/\n manage.py\n mysite/\n __init__.py\n settings.py\n urls.py\n asgi.py\n wsgi.py\nDessa filer är:
\nmanage.py: Ett kommandoradsverktyg som låter dig interagera med det här Django-projektet på olika sätt. Du kan läsa alla detaljer om manage.py i django-admin och manage.py.
mysite/: En katalog som är det faktiska Python-paketet för ditt projekt. Dess namn är det Python-paketnamn som du måste använda för att importera något i den (t.ex. mysite.urls).
mysite/__init__.py: En tom fil som talar om för Python att den här katalogen ska betraktas som ett Python-paket. Om du är nybörjare i Python, läs mer om paket i de officiella Python-dokumenten.
mysite/settings.py: Inställningar/konfiguration för detta Django-projekt. Django-inställningar berättar allt om hur inställningar fungerar.
mysite/urls.py: URL-deklarationerna för det här Django-projektet; en ”innehållsförteckning” för din Django-drivna webbplats. Du kan läsa mer om webbadresser i URL-distributör.
mysite/asgi.py: En ingångspunkt för ASGI-kompatibla webbservrar för att betjäna ditt projekt. Se Så här distribuerar du med ASGI för mer information.
mysite/wsgi.py: An entry-point for WSGI-compatible web servers to\nserve your project. See Så här distribuerar du med WSGI for more details.
Låt oss verifiera att ditt Django-projekt fungerar. Byt till djangotutorial-katalogen, om du inte redan har gjort det, och kör följande kommandon:
Linux / macOS
$ python manage.py runserver\nWindows
...\\> py manage.py runserver\nDu kommer att se följande utdata på kommandoraden:
\nPerforming system checks...\n\nSystem check identified no issues (0 silenced).\n\nYou have unapplied migrations; your app may not work properly until they are applied.\nRun 'python manage.py migrate' to apply them.\n\nokt. 03, 2026 - 15:50:53\nDjango version 5.2, using settings 'mysite.settings'\nStarting development server at http://127.0.0.1:8000/\nQuit the server with CONTROL-C.\n\nWARNING: This is a development server. Do not use it in a production setting. Use a production WSGI or ASGI server instead.\nFor more information on production servers see: https://docs.djangoproject.com/en/5.2/howto/deployment/\n\n
Nu när servern är igång kan du besöka http://127.0.0.1:8000/ med din webbläsare. Du kommer att se en ”Grattis!”-sida med en raket som lyfter. Det fungerade!
\nDu har startat Djangos utvecklingsserver, en lättviktig webbserver som är skriven helt i Python. Vi har inkluderat detta med Django så att du kan utveckla saker snabbt, utan att behöva ta itu med att konfigurera en produktionsserver - till exempel Apache - tills du är redo för produktion.
\nNu är det dags att påpeka: använd inte den här servern i något som liknar en produktionsmiljö. Den är endast avsedd för användning under utveckling. (Vi är i branschen för att göra webbramverk, inte webbservrar)
\n(För att servera webbplatsen på en annan port, se runserver-referensen)
Nu när din miljö - ett ”projekt” - har skapats är du redo att börja arbeta.
\nVarje applikation du skriver i Django består av ett Python-paket som följer en viss konvention. Django levereras med ett verktyg som automatiskt genererar den grundläggande katalogstrukturen för en app, så att du kan fokusera på att skriva kod istället för att skapa kataloger.
\n\nDina appar kan ligga var som helst i din Python-sökväg. I den här handledningen skapar vi vår poll-app i mappen djangotutorial.
För att skapa din app, se till att du befinner dig i samma katalog som manage.py och skriv detta kommando:
Linux / macOS
$ python manage.py startapp polls\nWindows
...\\> py manage.py startapp polls\nDet skapar en katalog polls, som är uppbyggd så här:
polls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n views.py\nDenna katalogstruktur kommer att hysa pollapplikationen.
\nLåt oss skriva den första vyn. Öppna filen polls/views.py och lägg in följande Python-kod i den:
polls/views.pyfrom django.http import HttpResponse\n\n\ndef index(request):\n return HttpResponse("Hello, world. You're at the polls index.")\nDetta är den mest grundläggande vyn som är möjlig i Django. För att komma åt den i en webbläsare måste vi mappa den till en URL - och för detta måste vi definiera en URL-konfiguration, eller ”URLconf” för kort. Dessa URL-konfigurationer definieras i varje Django-app, och de är Python-filer med namnet urls.py.
För att definiera en URLconf för appen polls skapar du en fil polls/urls.py med följande innehåll:
polls/urls.pyfrom django.urls import path\n\nfrom . import views\n\nurlpatterns = [\n path("", views.index, name="index"),\n]\nDin appkatalog bör nu se ut som följer:
\npolls/\n __init__.py\n admin.py\n apps.py\n migrations/\n __init__.py\n models.py\n tests.py\n urls.py\n views.py\nNästa steg är att konfigurera rot-URLconf i projektet mysite så att den inkluderar URLconf som definieras i polls.urls. För att göra detta lägger du till en import för django.urls.include i mysite/urls.py och infogar en include() i listan urlpatterns, så att du har:
mysite/urls.pyfrom django.contrib import admin\nfrom django.urls import include, path\n\nurlpatterns = [\n path("polls/", include("polls.urls")),\n path("admin/", admin.site.urls),\n]\nFunktionen path() förväntar sig minst två argument: route och view. Funktionen include() tillåter referenser till andra URLconfs. När Django stöter på include(), hugger den av den del av URL:en som matchade fram till den punkten och skickar den återstående strängen till den inkluderade URLconf för vidare bearbetning.
Tanken bakom include() är att göra det enkelt att plugga in och spela upp webbadresser. Eftersom omröstningar finns i sin egen URLconf (polls/urls.py) kan de placeras under ”/polls/”, eller under ”/fun_polls/”, eller under ”/content/polls/”, eller någon annan sökvägsrot, och appen kommer fortfarande att fungera.
Du har nu kopplat en index-vy till URLconf. Verifiera att det fungerar med följande kommando:
Linux / macOS
$ python manage.py runserver\nWindows
...\\> py manage.py runserver\nGå till http://localhost:8000/polls/ i din webbläsare, och du bör se texten ”Hello, world. You’re at the polls index.”, som du definierade i vyn index.
När du känner dig bekväm med det grundläggande flödet för begäran och svar kan du läsa del 2 av denna handledning för att börja arbeta med databasen.
\n