NPM installeren op Windows is niet bepaald een kwestie van hogere wiskunde, maar het is een van die dingen waarbij je beseft dat de duivel echt in de details zit. Misschien heb je geprobeerd Node.js en npm te installeren, maar wordt npm niet herkend in je opdrachtregel, of krijg je vreemde foutmeldingen zoals “opdracht niet gevonden”.Of misschien wil je er zeker van zijn dat alles soepel loopt voordat je aan grote projecten begint. Wat de reden ook is, het oplossen van deze problemen kan frustrerend zijn, vooral wanneer Windows soms gewoon weigert om goed met omgevingsvariabelen om te gaan. Deze handleiding helpt je bij het oplossen van veelvoorkomende problemen en zorgt ervoor dat npm betrouwbaar werkt op Windows, zodat je minder tijd hoeft te besteden aan rommelen en meer tijd hebt om daadwerkelijk te programmeren.
Hoe u het probleem ‘npm niet herkend’ op Windows kunt oplossen
Methode 1: Zorg ervoor dat Node.js en npm correct zijn geïnstalleerd en in PATH staan
Dit is het meest voorkomende probleem: npm is geïnstalleerd, maar Windows kan het niet vinden omdat het systeempad niet de map bevat waar npm zich bevindt. Je hebt Node.js waarschijnlijk vanaf de officiële website geïnstalleerd, maar soms wordt tijdens de installatie het selectievakje om Node aan PATH toe te voegen over het hoofd gezien, of vergeet Windows gewoon om omgevingsvariabelen direct bij te werken. In dat geval herkent een nieuwe opdrachtprompt npm-opdrachten niet. Dit is wat je moet doen:
- Druk op de Windows-toets, typ Omgevingsvariabelen en selecteer De systeemomgevingsvariabelen bewerken.
- Klik in het venster Systeemeigenschappen op Omgevingsvariabelen.
- Scroll onder Systeemvariabelen naar beneden tot u Pad vindt en klik vervolgens op Bewerken.
- Controleer of er een pad naar je Node.js-map is, meestal iets als
C:\Program Files\nodejs\. Als het ontbreekt, klik dan op Nieuw en voeg dat pad toe. - Klik helemaal op OK
npm -ven start de opdrachtprompt opnieuw. Typ vervolgens. Als er een versienummer wordt weergegeven, is dat een succes.
Deze oplossing is nuttig omdat Windows moet weten waar npm te vinden is wanneer je het aanroept. Als het niet in PATH staat, negeert Windows de opdracht in principe gewoon omdat het geen idee heeft waar npm zich bevindt.
Methode 2: Node.js opnieuw installeren en ervoor zorgen dat u PATH toevoegt
Als bovenstaande npm nog steeds niet herkent, is het wellicht makkelijker om Node.js opnieuw te installeren. Soms voegt een installatie Node.js niet automatisch toe aan PATH, vooral als je een stap overslaat tijdens de installatie. Om dit te verhelpen:
- Download de nieuwste LTS-versie van de officiële Node.js-downloadpagina.
- Voer het installatieprogramma uit en let op de installatiestappen. Er is een optie met de tekst ‘Toevoegen aan PATH’ of ‘Omgevingsvariabelen automatisch instellen’.Zorg ervoor dat dit is aangevinkt. Windows doet dit soms natuurlijk wat subtiel, dus controleer het goed.
- Voltooi de installatie en open een nieuwe opdrachtprompt. Voer de opdracht
npm -vopnieuw uit. Hopelijk werkt het nu.
Vaak is het probleem hiermee opgelost, omdat een nieuwe installatie met de juiste opties alles netjes opstart.
Methode 3: Controleren of npm daadwerkelijk is geïnstalleerd
In veel gevallen is het gewoon een kwestie van controleren of npm aanwezig is, of dat er misschien iets mis is gegaan tijdens de installatie. Ga naar C:\Program Files\nodejs\ of waar je Node ook hebt geïnstalleerd. Zoek in die map naar npm.cmd of npm. Als het daar niet staat, is npm niet goed geïnstalleerd en moet je Node.js mogelijk helemaal opnieuw installeren.
Pro tip: voer node -vde opdrachtprompt uit om te controleren of Node.js zelf draait. Als daar een versie wordt weergegeven, maar npm -vniet, dan ligt het probleem zeker bij npm, niet bij Node.js.
Methode 4: NVM voor Windows gebruiken om meerdere knooppuntversies te beheren
Misschien heb je Node.js meerdere keren geïnstalleerd, of botsen sommige andere versies met elkaar. Dit kan ertoe leiden dat npm vastloopt of ontoegankelijk is. Nvm voor Windows (een Node Version Manager) helpt deze overzichtelijk te houden, waardoor het installeren en wisselen tussen verschillende Node-versies een fluitje van een cent wordt. Dit is best handig als je met verschillende projecten werkt of specifieke Node/npm-versies nodig hebt:
- Download nvm voor Windows van de GitHub-repository.
- Installeer het en gebruik dan opdrachten als en.
nvm installnvm use - Zodra een versie actief is, controleert u of npm werkt door
npm -v.uit te voeren.
Het is niet voor iedereen absoluut noodzakelijk, maar soms helpt het om over te stappen op een versie waarvan je weet dat die goed is om vreemde pad- of toestemmingsproblemen op te lossen. Bovendien houdt het de boel overzichtelijk.
Methode 5: npm-cache wissen en npm-pakketten opnieuw installeren
Oh, en soms is het niet het PATH, maar een beschadigde npm-cache die de boel in de war schopt. Om even snel een controle uit te voeren:
- Open de opdrachtprompt als beheerder.
- Typ
npm cache clean --forceom de cache te wissen. Dit helpt als npm vreemde fouten geeft of zich vreemd gedraagt. - Probeer het dan
npm -vopnieuw. Als het nog steeds niet werkt, overweeg dan om npm zelf opnieuw te installeren via de handmatige npm-installatie (hoewel het meestal wel lukt om Node.js opnieuw te installeren).
In sommige configuraties kan een beschadigde cache of een rommelige npm-map herkenningsfouten veroorzaken. Het wissen ervan lost dit vreemde gedrag vaak op.
Soms wil Windows gewoon moeilijk doen, en dan is er wat gepriegel nodig om alles op één lijn te krijgen. Ik weet niet zeker waarom het werkt, maar na wat gepriegel komt npm eindelijk tot leven – en dat is waar het om draait.