Sådan foretager du fejlfinding og reparation af Node.js- og npm-installationer på Windows og macOS

Hvis du nogensinde har prøvet at starte et projekt og opdaget, at terminalen ikke genkender kommandoer, eller at globale pakker er gået amok, så gå ikke i panik. Det er mere almindeligt, end du måske tror. Node.js og npm installationer De bliver beskadiget eller forårsager problemer, især når vi hopper fra én version til en anden, eller når operativsystemets tilladelser bliver kræsne.

For at bringe orden i dette kaos er det første, man skal forstå, at Node.js er det miljø, der giver dig mulighed for at køre JavaScript uden for browseren, mens npm er ansvarlig for at administrere alle bibliotekerne. Når disse to ikke passer sammen, er den bedste fremgangsmåde ikke at forsøge at "patche" den nuværende installation, men snarere påfør en dybderensning og geninstaller ved hjælp af værktøjer, der forhindrer problemet i at gentage sig i fremtiden.

Valg af den rigtige version: LTS eller Current?

Før du starter reparationen, skal du beslutte, hvilken vej du skal gå. Versionen LTS (langsigtet support) Det er det sikre valg; det er den, du bør bruge, hvis du leder efter total stabilitet i produktionen, eller hvis du lige er startet, da den er bredt testet og sjældent forårsager overraskelser.

På den anden side har vi versionen NuværendeDette er "den banebrydende kant", hvor de nyeste funktioner ankommer. Det er fantastisk til eksperimentering, eller hvis du har brug for en banebrydende funktion fra et framework, men husk at supporten er kortere, og det er her, der har tendens til at dukke flere fejl op. fejl eller inkompatibiliteter med ældre pakker.

Reparation og installation i Windows 11

Når Node.js fejler i Windows, skyldes det ofte et problem med stien. Hvis du brugte det officielle .msi-installationsprogram, skal du sørge for, at indstillingen [indsæt indstilling her] blev valgt under processen. Tilføj node til PATHHvis det stadig ikke virker, skal du manuelt gå til Systemegenskaber og tilføje stierne til y %AppData%\npm i brugermiljøvariablerne.

Hvis du foretrækker noget mere moderne og rent, anbefaler jeg at bruge Wingetsom allerede er integreret i Windows 10 og 11. Med en simpel kommando som Du kan få alt klar uden komplikationer. Der er også Chocolatey, et meget robust alternativ for dem, der elsker pakkeautomatisering via kommandolinjen.

For dem, der ønsker at undgå problemer med tilladelser og ændre versioner uden at ødelægge noget, kaldes løsningen nvm-windowsDet er et andet projekt end Linux/Mac-projektet, der giver dig mulighed for at installere flere versioner af Node og skifte mellem dem med forhindre globale værktøjer i at blive ustabile.

Løsninger til macOS- og Unix-miljøer

På Mac er den mest almindelige måde at bruge den officielle .pkg-pakke, men hvis du vil tage din arbejdsgang til det næste niveau, Hjemmebryg er værktøjet definitiv. Tillader installation af Node med og nemt holde den opdateret med en Der kan dog nogle gange være linkkonflikter, der løses med kommandoen .

Den virkelige "hellige gral" i macOS er dog nvm (Node Version Manager)Ved at installere Node via nvm gemmes filerne i din brugermappe og ikke i begrænsede systemmapper. Dette løser fuldstændigt det frygtede problem. EACCES-tilladelsesfejl, hvilket eliminerer behovet for at bruge kommandoen at installere globale pakker.

Hvis du bruger Linux (Ubuntu, Debian eller Fedora), er det bedst at bruge scripts fra NodeSource For at få opdaterede LTS-versioner. Husk, at hvis du bruger WSL (Windows Subsystem for Linux), er det bedst at installere Node direkte i Linux-distributionen og ikke blande Windows-binærfilen med WSL-binærfilen, da dette kan forårsage problemer. rutekonflikter ret irriterende.

Fejlfinding af almindelige fejl og vedligeholdelse

Hvis når man skriver Terminalen vil fortælle dig, at kommandoen ikke genkendes; gå ikke i panik. Det betyder normalt, at npm global bin-mappe Den er ikke i din PATH. På macOS og Linux skal du kontrollere, at din fil o indlæser nvm-konfigurationen korrekt ved login, hvilket forhindrer localhost nægtede at oprette forbindelse eller lignende lokale serverfejl.

For at opretholde et sundt miljø er det ikke nok blot at installere og glemme alt om det. Implementering er afgørende. af og til at opdage sikkerhedssårbarheder i din afdeling. Hvis du ser, at noget er forældet, Den vil fortælle dig, hvilke pakker der har brug for en hurtig opdatering.

Et trick for udviklere er at bruge NPXI stedet for at fylde dit system med globale installationer, der kan være i konflikt med hinanden, lader npx dig køre CLI'er midlertidigt. Hvis du desuden har brug for at administrere pnpm eller Yarn, skal du aktivere Kernepakke med kommandoen at have fuld kontrol over pakkeadministratorer.

For at efterlade systemet rent før en geninstallation, skal du i Windows ikke blot slette programmet fra indstillingerne, men også manuelt slette de resterende mapper i På en Mac, hvis du brugte Homebrew, en er normalt tilstrækkeligt, selvom rengøring af npm-cache med Det er altid en god idé at forhindre gamle fejl i at gentage sig.

At opretholde et sundt udviklingsmiljø indebærer altid at prioritere LTS-versioner, delegere versionskontrol til værktøjer som NVM eller FNM og for enhver pris undgå at bruge administratorrettigheder til at installere biblioteker. Ved korrekt at konfigurere miljøvariabler og rydde op i midlertidige filer kan vi sikre, at Node.js og npm kører problemfrit på ethvert operativsystem.

Relateret artikel:

Ret Localhost Refused to Connect-fejl i Windows

Isaac

Passioneret forfatter om bytes-verdenen og teknologien generelt. Jeg elsker at dele min viden gennem skrivning, og det er det, jeg vil gøre i denne blog, vise dig alle de mest interessante ting om gadgets, software, hardware, teknologiske trends og mere. Mit mål er at hjælpe dig med at navigere i den digitale verden på en enkel og underholdende måde.