Как да отстранявате неизправности и да поправяте инсталации на Node.js и npm на Windows и macOS

Ако някога сте се опитвали да стартирате проект и сте установили, че терминалът не разпознава команди или че глобалните пакети са се объркали, не се паникьосвайте. Това е по-често срещано, отколкото си мислите. Инсталации на Node.js и npm Те се повредят или причинят проблеми, особено когато преминаваме от една версия към друга или когато разрешенията на операционната система станат ограничени.

За да се внесе ред в този хаос, първото нещо, което трябва да се разбере, е, че Node.js е средата, която ви позволява да изпълнявате JavaScript извън браузъра, докато npm е отговорен за управлението на всички библиотеки. Когато тези две не се разбират, най-добрият подход не е да се опитвате да „закърпите“ текущата инсталация, а по-скоро нанесете дълбоко почистване и преинсталирайте, като използвате инструменти, които предотвратяват повтарянето на проблема в бъдеще.

Избор на правилната версия: LTS или Current?

Преди да започнете ремонта, трябва да решите кой път да поемете. Версията LTS (Дългосрочна поддръжка) Това е сигурният вариант; това е този, който трябва да използвате, ако търсите пълна стабилност в производството или ако тепърва започвате, тъй като е широко тестван и рядко предизвиква изненади.

От друга страна имаме версията АКТУАЛНОТова е „авангардът“, където пристигат най-новите функции. Чудесно е за експериментиране или ако имате нужда от авангардна функция от дадена рамка, но имайте предвид, че поддръжката е по-кратка и това е мястото, където обикновено се появяват повече грешки. грешки или несъвместимости с по-стари пакети.

Ремонт и инсталиране на Windows 11

Когато Node.js се провали в Windows, това често се дължи на проблем с пътя. Ако сте използвали официалния инсталатор на .msi, уверете се, че опцията [вмъкнете опция тук] е избрана по време на процеса. добавете възел към PATHАко все още не работи, ще трябва ръчно да отидете в „Свойства на системата“ и да добавите пътищата към y %AppData%\npm в променливите на потребителската среда.

Ако предпочитате нещо по-модерно и изчистено, препоръчвам да използвате WinGetкойто вече е интегриран в Windows 10 и 11. С проста команда като Можете да приготвите всичко без усложнения. Има и Chocolatey, много здрава алтернатива за тези, които обичат... автоматизация на пакети чрез командния ред.

За тези, които искат да избегнат проблеми с разрешенията и да променят версиите, без да нарушават нищо, решението се нарича nvm-windowsТова е различен проект от този за Linux/Mac, който ви позволява да инсталирате множество версии на Node и да превключвате между тях с... предотвратяване на нестабилността на глобалните инструменти.

Решения за macOS и Unix среди

На Mac най-разпространеният начин е да използвате официалния .pkg пакет, но ако искате да изведете работния си процес на следващото ниво, Домашното пивоварство е инструментът окончателно. Позволява инсталиране на Node с и лесно да го актуализирате с Понякога обаче може да има конфликти на връзки, които се разрешават с командата .

Истинският „свещен граал“ в macOS обаче е nvm (Мениджър на версии на възли)Чрез инсталиране на Node чрез nvm, файловете се запазват във вашата потребителска папка, а не в ограничени системни директории. Това напълно решава ужасния проблем. Грешки в разрешенията на EACCES, елиминирайки необходимостта от използване на командата за инсталиране на глобални пакети.

Ако използвате Linux (Ubuntu, Debian или Fedora), най-добре е да използвате скриптовете на NodeSource За да получите актуализирани LTS версии, не забравяйте, че ако използвате WSL (Windows Subsystem for Linux), най-добре е да инсталирате Node директно в Linux дистрибуцията и да не смесвате двоичния файл на Windows с двоичния файл на WSL, тъй като това може да причини проблеми. конфликти на маршрути доста досадно.

Отстраняване на често срещани грешки и поддръжка

Ако при писане Терминалът ще ви каже, че командата не е разпозната; не се паникьосвайте. Това обикновено означава, че npm глобална директория на bin Не е във вашия PATH. В macOS и Linux проверете дали файлът ви o правилно зарежда nvm конфигурацията при влизане, като по този начин предотвратява localhost отказа да се свърже или подобни локални сървърни повреди.

За да се поддържа здравословна среда, не е достатъчно просто да се инсталира и да се забрави за него. Внедряването е от съществено значение. от време на време за откриване уязвимости в сигурността във вашия отдел. Ако видите, че нещо е остаряло, Ще ви каже кои пакети се нуждаят от спешна актуализация.

Един трик за разработчиците е да използват npxВместо да запълвате системата си с глобални инсталации, които могат да си противоречат, npx ви позволява временно да изпълнявате CLI. Освен това, ако трябва да управлявате pnpm или Yarn, активирайте Корен пакет с командата да има пълен контрол над мениджърите на пакети.

За да оставите системата чиста преди преинсталиране, в Windows трябва не само да изтриете приложението от настройките, но и ръчно да изтриете останалите папки в На Mac, ако сте използвали Homebrew, a обикновено е достатъчно, въпреки че почистването на npm кеш с Винаги е добра идея да се предотврати повтарянето на стари грешки.

Поддържането на здравословна среда за разработка включва винаги приоритизиране на LTS версиите, делегиране на контрола на версиите на инструменти като NVM или FNM и избягване на използването на администраторски права за инсталиране на библиотеки на всяка цена. Чрез правилно конфигуриране на променливите на средата и почистване на временните файлове можем да гарантираме, че Node.js и npm работят безпроблемно на всяка операционна система.

Свързана статия:

Коригирайте грешката Localhost Refused to Connect в Windows

Isaac

Страстен писател за света на байтовете и технологиите като цяло. Обичам да споделям знанията си чрез писане и това е, което ще направя в този блог, ще ви покажа всички най-интересни неща за джаджи, софтуер, хардуер, технологични тенденции и много други. Моята цел е да ви помогна да се ориентирате в дигиталния свят по лесен и забавен начин.