Node.js és npm telepítések hibaelhárítása és javítása Windows és macOS rendszeren

Ha valaha is megpróbáltál elindítani egy projektet, és azt tapasztaltad, hogy a terminál nem ismeri fel a parancsokat, vagy hogy a globális csomagok elromlottak, ne ess pánikba. Ez gyakoribb, mint gondolnád. Node.js és npm telepítések Megsérülnek vagy problémákat okoznak, különösen akkor, amikor egyik verzióról a másikra ugrunk, vagy amikor az operációs rendszer engedélyei válnak bonyolulttá.

Hogy rendet teremtsünk ebben a káoszban, először is meg kell értenünk, hogy a Node.js az a környezet, amely lehetővé teszi a JavaScript futtatását a böngészőn kívül, míg az npm felelős az összes könyvtár kezeléséért. Amikor ez a kettő nem fér meg egymással, a legjobb megközelítés nem az, hogy megpróbáljuk „foltozni” a jelenlegi telepítést, hanem inkább alkalmazzon mélytisztítást és telepítse újra olyan eszközökkel, amelyek megakadályozzák a probléma jövőbeni megismétlődését.

A megfelelő verzió kiválasztása: LTS vagy Current?

A javítás megkezdése előtt el kell döntenie, hogy melyik utat választja. A verzió LTS (hosszú távú támogatás) Ez a biztos választás; ezt kell használnod, ha teljes stabilitásra vágysz éles környezetben, vagy ha most kezded, mivel széles körben tesztelték és ritkán okoz meglepetéseket.

Másrészt megvan a verzió JelenlegiEz az „élvonalbeli” rész, ahol a legújabb funkciók érkeznek. Nagyszerű kísérletezéshez, vagy ha egy keretrendszer élvonalbeli funkciójára van szükséged, de ne feledd, hogy a támogatás rövidebb, és itt szokott több hiba megjelenni. hibák vagy inkompatibilitások régebbi csomagokkal.

Javítás és telepítés Windows 11 rendszerben

Amikor a Node.js Windows rendszeren hibát jelez, az gyakran elérési úttal kapcsolatos probléma miatt van. Ha a hivatalos .msi telepítőt használta, győződjön meg arról, hogy a [ide kell beszúrni a lehetőséget] opció ki van választva a folyamat során. Csomópont hozzáadása a PATH-hozHa továbbra sem működik, manuálisan kell megnyitnia a Rendszertulajdonságok menüpontot, és hozzá kell adnia az elérési utakat a következőhöz: y %AppData%\npm a felhasználói környezeti változókban.

Ha valami modernebbet és letisztultabbat szeretnél, akkor azt javaslom, hogy használd Wingetamely már integrálva van a Windows 10 és 11 rendszerbe. Egy egyszerű paranccsal, mint például Mindent gond nélkül elkészíthetsz. Létezik a Csokis is, ami egy nagyon robusztus alternatíva azoknak, akik szeretik a... csomagautomatizálás a parancssoron keresztül.

Azok számára, akik el akarják kerülni az engedélyezési problémákat, és a verziókat anélkül szeretnék módosítani, hogy bármit is megsértenének, a megoldás az ún. nvm-windowsEz egy másik projekt, mint a Linux/Mac, amely lehetővé teszi a Node több verziójának telepítését és a közöttük való váltást a következővel: a globális eszközök instabillá válásának megakadályozása.

Megoldások macOS és Unix környezetekhez

Macen a leggyakoribb módszer a hivatalos .pkg csomag használata, de ha a következő szintre szeretnéd emelni a munkafolyamatodat, A házisörfőzés az eszköz végleges. Lehetővé teszi a Node telepítését a következővel: és könnyen naprakészen tarthatja egy Előfordulhatnak azonban linkütközések, amelyeket a következő paranccsal oldhatunk meg: .

A macOS igazi „szent grálja” azonban az nvm (Node Version Manager)A Node nvm-en keresztüli telepítésével a fájlok a felhasználói mappába kerülnek mentésre, nem pedig korlátozott rendszerkönyvtárakba. Ez teljesen megoldja a rettegett problémát. EACCES jogosultsági hibák, így nincs szükség a parancs használatára globális csomagok telepítéséhez.

Ha Linuxot (Ubuntu, Debian vagy Fedora) használsz, akkor a legjobb, ha a következő szkripteket használod: NodeSource A frissített LTS verziók beszerzéséhez ne feledd, hogy ha WSL-t (Windows Subsystem for Linux) használsz, akkor a legjobb, ha a Node-ot közvetlenül a Linux disztribúción belül telepíted, és nem kevered a Windows bináris fájlt a WSL bináris fájllal, mivel ez problémákat okozhat. útvonalütközések elég idegesítő.

Gyakori hibák elhárítása és karbantartás

Ha írás közben A terminál azt fogja mondani, hogy a parancsot nem ismeri fel; ne essen pánikba. Ez általában azt jelenti, hogy a npm globális bin könyvtár Nincs a PATH-ban. macOS és Linux rendszeren ellenőrizze, hogy a fájl o helyesen tölti be az nvm konfigurációját bejelentkezéskor, így megakadályozza a A localhost nem volt hajlandó csatlakozni vagy hasonló helyi szerverhibák.

Az egészséges környezet fenntartásához nem elég egyszerűen telepíteni és elfelejteni. A megvalósítás elengedhetetlen. időnként észlelni biztonsági rések az osztályodon. Ha azt látod, hogy valami elavult, Meg fogja mondani, hogy mely csomagoknak van szükségük sürgős frissítésre.

Az egyik trükk a fejlesztők számára az, hogy npxAhelyett, hogy a rendszert globális telepítésekkel töltené meg, amelyek ütközhetnek egymással, az npx lehetővé teszi a parancssori felületek ideiglenes futtatását. Továbbá, ha a pnpm vagy a Yarn kezelésére van szüksége, engedélyezze a Corepack a paranccsal hogy teljes kontrollal rendelkezzen a csomagkezelők felett.

A rendszer újratelepítése előtti tisztán hagyásához Windows rendszerben nemcsak az alkalmazást kell törölni a beállításokból, hanem manuálisan is törölni kell a maradék mappákat a Macen, ha Homebrew-t használtál, egy általában elegendő, bár a tisztítás npm gyorsítótár a Mindig jó ötlet megakadályozni a régi hibák megismétlődését.

Az egészséges fejlesztői környezet fenntartása magában foglalja az LTS verziók priorizálását, a verziókövetés olyan eszközökre való delegálását, mint az NVM vagy az FNM, és a könyvtárak telepítéséhez való rendszergazdai jogosultságok használatának mindenáron történő elkerülését. A környezeti változók megfelelő konfigurálásával és az ideiglenes fájlok törlésével biztosíthatjuk, hogy a Node.js és az npm zökkenőmentesen fusson bármilyen operációs rendszeren.

Kapcsolódó cikk:

Javítsa ki a Localhost Refused to Connect hibát a Windows rendszerben

Izsák

Szenvedélyes író a bájtok és általában a technológia világáról. Szeretem megosztani tudásomat írásban, és ezt fogom tenni ebben a blogban, megmutatom a legérdekesebb dolgokat a kütyükről, szoftverekről, hardverekről, technológiai trendekről stb. Célom, hogy egyszerű és szórakoztató módon segítsek eligazodni a digitális világban.