npm-kommandon: guide till pakethantering

01Vad är npm och vad används det till?

npm (Node Package Manager) är JavaScript-världens pakethanterare. Med den lägger du till bibliotek som andra har skrivit i ditt projekt, håller koll på deras versioner och kör projektets kommandon från ett och samma ställe.

npm följer med Node.js, så du behöver inte installera det separat. Har du inte installerat Node.js ännu, börja med vår guide till installation av Node.js och testa sedan kommandona i den här artikeln i din egen terminal.

npm består av tre delar: ett kommandoradsverktyg på din dator, ett register (registry) där paketen lagras och filen package.json som är hjärtat i varje projekt. Nästan alla kommandon läser eller uppdaterar den här filen.

02Vad är package.json?

package.json är projektets ID-kort: här står namn, version, beroenden och de skript som går att köra. I ett nytt projekt skapar du filen med npm init, och flaggan -y hoppar över alla frågor med standardsvar.

• dependencies: paket som applikationen behöver när den körs.
• devDependencies: verktyg som bara behövs under utveckling och bygge (kompilator, testverktyg, kodformaterare).
• scripts: korta kommandon som körs med npm run.
• package-lock.json: sparar den exakta versionen av varje installerat paket. Lägg alltid till den här filen i Git.

mkdir ilk-proje
cd ilk-proje
npm init -y

{
  "name": "ilk-proje",
  "version": "1.0.0",
  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "test": "node --test"
  },
  "dependencies": {
    "axios": "^1.7.0"
  },
  "devDependencies": {
    "vite": "^6.0.0"
  }
}

03Installera paket med npm install

npm install är det vanligaste kommandot och gör två olika saker. Skrivs det ensamt installerar det alla beroenden i package.json i mappen node_modules. Skrivs det med ett paketnamn installerar det paketet och lägger till det i package.json. Kortversionen är npm i.

# Installera alla beroenden i projektet
npm install

# Yeni paket ekle (dependencies)
npm install axios

# Lägg till ett utvecklingsverktyg (devDependencies)
npm install -D prettier

# Installera en viss version
npm install lodash@4

# Global installation (för kommandoradsverktyg)
npm install -g serve

# Ta bort paketet
npm uninstall axios

Globalt eller lokalt?

Installera paket lokalt så ofta det går, så att projektet fungerar med samma versioner på en annan dator. Spara globala installationer för kommandoradsverktyg som du använder överallt, och för engångsverktyg räcker npx.

När används npm ci?

npm ci tar bort mappen node_modules och installerar exakt de versioner som står i package-lock.json, utan att ändra låsfilen. Det passar perfekt vid driftsättning på server, i pipelines för kontinuerlig integration och för att lösa problemet med “det fungerade på min dator”.

04Köra skript med npm run

Fältet scripts i package.json låter dig ge långa kommandon korta namn. Då kan alla i teamet starta utvecklingsservern med npm run dev och produktionsbygget med npm run build utan att känna till verktygets detaljer.

Vissa namn, som start och test, är speciella och körs utan run. Extra parametrar skickar du till skriptet med två bindestreck.

npm run dev
npm run build
npm start
npm test

# Lista alla definierade skript
npm run

# Skicka parametrar till skriptet
npm run build -- --mode staging

Skripten pre och post

Lägger du pre eller post framför namnet på ett skript kör npm det automatiskt före respektive efter. Ett skript som heter prebuild kan till exempel rensa den gamla build-mappen direkt före npm run build. Med den ordningen glömmer ingen i teamet ett steg.

Varför hittar skripten lokala verktyg?

När npm run körs lägger det tillfälligt till projektets node_modules/.bin i PATH. Därför räcker det att skriva vite eller prettier i skriptet, och du behöver inte installera verktyget globalt. Om samma verktyg inte hittas när du skriver det direkt i terminalen är det därför, och lösningen är att använda npx.

Skillnader mellan operativsystem i skript

Kommandon som rm -rf fungerar inte i Windows standardskal. Om teamet använder olika operativsystem bör du välja plattformsoberoende Node.js-verktyg eller korta Node.js-skript i dina skript, så att samma package.json ger samma resultat på varje maskin.

05Uppdatera och granska paket

Paket uppdateras regelbundet: säkerhetshål täpps till och nya funktioner tillkommer. Kör kommandot npm outdated för att se vad som är inaktuellt innan du uppdaterar.

Tecknet ^ i package.json tillåter mindre versioner och patchversioner (1.7.0 → 1.9.2), medan ~ bara tillåter patchversioner (1.7.0 → 1.7.5). npm update uppdaterar inom de gränserna. För att hoppa till en ny huvudversion måste du installera om paketet med @latest, och det kräver oftast ändringar i koden.

# Eskiyen paketleri listele
npm outdated

# Uppdatera inom tillåtet intervall
npm update

# Byt till ny huvudversion (använd med försiktighet)
npm install axios@latest

# Säkerhetsgranskning
npm audit
npm audit fix

# Visa installerade paket
npm ls --depth=0
npm ls -g --depth=0

# Senaste publicerade version av ett paket
npm view axios version

06Vad är npx och när använder man det?

npx är en paketkörare som följer med npm. Med den kör du ett verktyg en enda gång utan att installera det globalt. Verktyget söks först i projektets node_modules och laddas annars ned tillfälligt.

Det vanligaste användningsområdet för npx är att skapa en projektmall. Du startar till exempel ett nytt React-projekt med Vite via kommandot npm create. Detaljerna hittar du i vår artikel om att installera React med Vite.

# Publicera mappen på en lokal server
npx serve .

# Kör formateraren som är installerad i projektet
npx prettier --write .

# Nytt projekt från mall (gör samma sak som npm create, npx create-...)
npm create vite@latest

07Skillnaden mellan npm, yarn och pnpm

npm är inte det enda alternativet. Även yarn och pnpm installerar paket från samma register. Alla tre använder package.json, så projektstrukturen ändras inte. Skillnaden syns i installationshastighet, diskutrymme och låsfil.

• Använd bara en pakethanterare i ett projekt. Två låsfiler samtidigt leder till versionsröra.
• Går du med i ett befintligt projekt, titta på låsfilen i mappen och välj samma verktyg.
• Om du precis har börjat är npm den smidigaste vägen.

08Vanliga fel och lösningar

De flesta npm-fel beror på skadad cache, en Node.js-version som inte passar eller beroenden som krockar. Läs först de första raderna i felmeddelandet, för lösningen står ofta där.

• ERESOLVE / peer dependency-fel: ett av paketen förväntar sig en annan version av ett annat paket. Uppdatera paketen till kompatibla versioner. Som tillfällig lösning kan du använda npm install --legacy-peer-deps.
• Skadad node_modules: ta bort mappen node_modules och kör npm install eller npm ci. Att ta bort låsfilen är sista utvägen.
• Cacheproblem: npm cache verify kontrollerar cachen. Rensa den vid behov med npm cache clean --force.
• EACCES-behörighetsfel: använd inte sudo vid global installation. Installera i stället om Node.js med nvm.
• Engine-varning: kräver paketet en nyare Node.js-version, byt till LTS-versionen med nvm.

09Använda npm rätt i dina projekt

För många paket ökar både säkerhetsrisken och mängden JavaScript som sidan skickar till webbläsaren. Att fråga sig “kan jag lösa det här med några rader kod?” före varje nytt beroende är den billigaste optimeringen för sidhastigheten. Det här ämnet tar vi regelbundet upp i vår tjänst hastighet och prestanda.

Lägg aldrig till mappen node_modules i Git. Skriv in den i .gitignore och dela bara package.json och låsfilen. Hur du skickar projektet till ett fjärrförråd har vi gått igenom steg för steg i guiden ladda upp ett projekt på GitHub.

Planerar du webbdesign för ditt företag eller ett integrationsprojekt som kopplar ihop betalning, frakt och bokföring, sänker en korrekt uppsatt beroendehantering underhållskostnaderna på sikt. Mer innehåll om Node.js hittar du på sidan för taggen nodejs.