Ako riešiť problémy a opraviť inštalácie Node.js a npm v systémoch Windows a macOS

Ak ste sa niekedy pokúsili spustiť projekt a zistili ste, že terminál nerozpoznáva príkazy alebo že globálne balíky sa pokazili, neprepadajte panike. Je to bežnejšie, než si myslíte. Inštalácie Node.js a npm Poškodia sa alebo spôsobia problémy, najmä keď prechádzame z jednej verzie na druhú alebo keď sa povolenia operačného systému stanú náročnými.

Aby sme vniesli do tohto chaosu poriadok, najprv treba pochopiť, že Node.js je prostredie, ktoré umožňuje spúšťať JavaScript mimo prehliadača, zatiaľ čo npm je zodpovedný za správu všetkých knižníc. Keď si tieto dve veci nerozumejú, najlepším prístupom nie je snažiť sa „opraviť“ aktuálnu inštaláciu, ale skôr... aplikujte hĺbkové čistenie a preinštalujte ho pomocou nástrojov, ktoré zabránia opakovaniu problému v budúcnosti.

Výber správnej verzie: LTS alebo Current?

Pred začatím opravy sa musíte rozhodnúť, ktorou cestou sa vydáte. Verzia LTS (Dlhodobá podpora) Je to stávka na istotu; mali by ste ju použiť, ak hľadáte úplnú stabilitu v produkcii alebo ak práve začínate, pretože je široko testovaná a zriedka spôsobuje prekvapenia.

Na druhej strane máme verziu prúdToto je „špičková hrana“, kde prichádzajú najnovšie funkcie. Je to skvelé na experimentovanie alebo ak potrebujete špičkovú funkciu z frameworku, ale majte na pamäti, že podpora je kratšia a práve tu sa zvyčajne objavuje viac chýb. chyby alebo nekompatibility so staršími balíkmi.

Oprava a inštalácia systému Windows 11

Keď Node.js zlyhá vo Windowse, často je to kvôli problému s cestou. Ak ste použili oficiálny inštalátor .msi, uistite sa, že počas procesu bola vybratá možnosť [sem vložte možnosť]. pridať uzol do PATHAk to stále nefunguje, budete musieť manuálne prejsť do Vlastností systému a pridať cesty k y %AppData%\npm v premenných používateľského prostredia.

Ak uprednostňujete niečo modernejšie a čistejšie, odporúčam použiť Wingetktorý je už integrovaný do Windowsu 10 a 11. Jednoduchým príkazom ako Všetko si môžete pripraviť bez komplikácií. Existuje aj Chocolatey, veľmi robustná alternatíva pre tých, ktorí milujú automatizácia balíkov prostredníctvom príkazového riadku.

Pre tých, ktorí sa chcú vyhnúť problémom s povoleniami a zmeniť verzie bez toho, aby niečo porušili, existuje riešenie s názvom nvm-windowsJe to iný projekt ako ten pre Linux/Mac, ktorý vám umožňuje nainštalovať viacero verzií Node a prepínať medzi nimi pomocou... zabránenie nestabilite globálnych nástrojov.

Riešenia pre prostredia macOS a Unix

Na Macu je najbežnejším spôsobom použitie oficiálneho balíka .pkg, ale ak chcete posunúť svoj pracovný postup na vyššiu úroveň, Domáce pivo je nástroj definitívne. Umožňuje inštaláciu Node s a jednoducho ho aktualizovať pomocou Niekedy sa však môžu vyskytnúť konflikty odkazov, ktoré sa vyriešia príkazom .

Skutočným „svätým grálom“ v systéme macOS je však nvm (Správca verzií uzla)Inštaláciou Node cez nvm sa súbory ukladajú do používateľského priečinka a nie do obmedzených systémových adresárov. Tým sa tento obávaný problém úplne vyrieši. Chyby oprávnení EACCES, čím sa eliminuje potreba použitia príkazu nainštalovať globálne balíky.

Ak používate Linux (Ubuntu, Debian alebo Fedora), najlepšie je použiť skripty od NodeSource Ak chcete získať aktualizované verzie LTS, nezabudnite, že ak používate WSL (Windows Subsystem for Linux), je najlepšie nainštalovať Node priamo v rámci distribúcie Linuxu a nemiešať binárny súbor Windows s binárnym súborom WSL, pretože by to mohlo spôsobiť problémy. konflikty trás dosť otravné.

Riešenie bežných chýb a údržba

Ak pri písaní Terminál vám oznámi, že príkaz nebol rozpoznaný; neprepadajte panike. Zvyčajne to znamená, že globálny adresár bin npm Nie je vo vašej ceste PATH. V systémoch macOS a Linux skontrolujte, či je váš súbor o správne načítava konfiguráciu nvm pri prihlásení, čím zabraňuje localhost sa odmietol pripojiť alebo podobné zlyhania lokálneho servera.

Na udržanie zdravého prostredia nestačí len nainštalovať a zabudnúť na to. Implementácia je nevyhnutná. občas zistiť zraniteľné miesta zabezpečenia vo vašom oddelení. Ak zistíte, že niečo je zastarané, Povie vám, ktoré balíky potrebujú urgentnú aktualizáciu.

Jeden trik pre vývojárov je použiť NPXNamiesto zapĺňania systému globálnymi inštaláciami, ktoré môžu navzájom kolidovať, vám npx umožňuje dočasne spúšťať rozhrania príkazového riadka. Okrem toho, ak potrebujete spravovať pnpm alebo Yarn, povoľte Základný balíček príkazom mať úplnú kontrolu nad správcami balíkov.

Ak chcete pred preinštalovaním systému nechať systém čistý, musíte v systéme Windows nielen odstrániť aplikáciu z nastavení, ale aj manuálne odstrániť zvyšné priečinky v Na počítači Mac, ak ste používali Homebrew, zvyčajne postačuje, hoci čistenie vyrovnávacia pamäť npm s Vždy je dobré predchádzať opakovaniu starých chýb.

Udržiavanie zdravého vývojového prostredia zahŕňa neustále uprednostňovanie verzií LTS, delegovanie správy verzií na nástroje ako NVM alebo FNM a za každú cenu vyhýbanie sa používaniu administrátorských oprávnení na inštaláciu knižníc. Správnou konfiguráciou premenných prostredia a vyčistením dočasných súborov môžeme zabezpečiť, aby Node.js a npm bežali hladko na akomkoľvek operačnom systéme.

Súvisiaci článok:

Opravte chybu Localhost Refused to Connect v systéme Windows

Isaac

Vášnivý spisovateľ o svete bajtov a technológií všeobecne. Milujem zdieľanie svojich vedomostí prostredníctvom písania, a to je to, čo urobím v tomto blogu, ukážem vám všetko najzaujímavejšie o gadgetoch, softvéri, hardvéri, technologických trendoch a ďalších. Mojím cieľom je pomôcť vám orientovať sa v digitálnom svete jednoduchým a zábavným spôsobom.