Så här installerar du Django på Windows

Detta dokument guidar dig genom installationen av Python 3.13 och Django på Windows. Det innehåller också instruktioner för att skapa en virtuell miljö, vilket gör det enklare att arbeta med Python-projekt. Detta är tänkt som en nybörjarguide för användare som arbetar med Django-projekt och återspeglar inte hur Django bör installeras när man utvecklar ändringar för Django själv.

Stegen i den här guiden har testats med Windows 10. I andra versioner skulle stegen vara liknande. Du måste vara bekant med att använda kommandotolken i Windows.

Installera Python

Django är ett Python-webbramverk och kräver därför att Python är installerat på din maskin. I skrivande stund är Python 3.13 den senaste versionen.

För att installera Python på din maskin, gå till https://www.python.org/downloads/. Webbplatsen bör erbjuda dig en nedladdningsknapp för den senaste Python-versionen. Ladda ner det körbara installationsprogrammet och kör det. Markera rutorna bredvid ”Installera startprogram för alla användare (rekommenderas)” och klicka sedan på ”Installera nu”.

Efter installationen öppnar du kommandotolken och kontrollerar att Python-versionen överensstämmer med den version du installerade genom att köra:

...\> py --version

py känns inte igen eller hittas inte

Beroende på hur du har installerat Python (t.ex. via Microsoft Store) kanske py inte är tillgängligt i kommandotolken.

Du måste då använda python i stället för py när du anger kommandon.

Se även

För mer information, se Using Python on Windows dokumentation.

Om pip

pip är en pakethanterare för Python och ingår som standard i Pythons installationsprogram. Den hjälper till att installera och avinstallera Python-paket (t.ex. Django!). Under resten av installationen kommer vi att använda pip för att installera Python-paket från kommandoraden.

Konfigurera en virtuell miljö

Det är bästa praxis att tillhandahålla en dedikerad miljö för varje Django-projekt som du skapar. Det finns många alternativ för att hantera miljöer och paket inom Python-ekosystemet, varav några rekommenderas i Python-dokumentationen. Python själv kommer med venv för hantering av miljöer som vi kommer att använda i den här guiden.

För att skapa en virtuell miljö för ditt projekt öppnar du en ny kommandotolk, navigerar till den mapp där du vill skapa ditt projekt och skriver sedan följande:

...\> py -m venv project-name

Detta skapar en mapp med namnet ”project-name” om den inte redan finns och konfigurerar den virtuella miljön. För att aktivera miljön, kör:

...\> project-name\Scripts\activate.bat

Den virtuella miljön kommer att aktiveras och du kommer att se ”(projektnamn)” bredvid kommandotolken för att ange det. Varje gång du startar en ny kommandotolk måste du aktivera miljön igen.

Installera Django

Django kan enkelt installeras med hjälp av pip i din virtuella miljö.

Kontrollera att den virtuella miljön är aktiv i kommandotolken och utför följande kommando:

...\> py -m pip install Django

Detta kommer att ladda ner och installera den senaste Django-versionen.

När installationen har slutförts kan du verifiera din Django-installation genom att köra django-admin --version i kommandotolken.

Se databasinstallation för information om databasinstallation med Django.

Färgad terminalutgång

En livskvalitetsfunktion lägger till färgad (i stället för svartvit) utdata till terminalen. I moderna terminaler bör detta fungera för både CMD och PowerShell. Om detta av någon anledning måste inaktiveras, ställ in miljövariabeln DJANGO_COLORS till nocolor.

På äldre Windows-versioner eller äldre terminaler måste colorama 0.4.6+ installeras för att aktivera syntaxfärgning:

...\> py -m pip install "colorama >= 0.4.6"

Se Syntax färgläggning för mer information om färginställningar.

Vanliga fallgropar

• Om django-admin bara visar hjälptexten oavsett vilka argument den får, finns det förmodligen ett problem med filassociationen i Windows. Kontrollera om det finns mer än en miljövariabel inställd för att köra Python-skript i PATH. Detta inträffar vanligtvis när det finns mer än en Python-version installerad.

• Om du ansluter till internet bakom en proxy kan det uppstå problem med att köra kommandot py -m pip install Django. Ställ in miljövariablerna för proxykonfiguration i kommandotolken enligt följande:

  ...\> set http_proxy=http://username:password@proxyserver:proxyport
  ...\> set https_proxy=https://username:password@proxyserver:proxyport
  

• I allmänhet antar Django att UTF-8-kodning används för I/O. Detta kan orsaka problem om ditt system är inställt på att använda en annan kodning. Nya versioner av Python tillåter inställning av miljövariabeln PYTHONUTF8 för att tvinga fram en UTF-8-kodning. Windows 10 tillhandahåller också en systemomfattande inställning genom att markera Use Unicode UTF-8 for worldwide language support i :menuselection:` Language –> Administrative Language Settings –> Change system locale i systeminställningarna.