Com solucionar i reparar instal·lacions de Node.js i npm a Windows i macOS

Si alguna vegada has intentat llançar un projecte i t'has topat que la terminal no reconeix les ordres o que els paquets globals s'han tornat bojos, no t'aclaparis. És més comú del que sembla que les instal·lacions de Node.js i npm es corrompen o donin guerra, especialment quan saltem d'una versió a una altra o quan els permisos del sistema operatiu es posen exquisits.

Per posar ordre en aquest caos, la primera cosa és entendre que Node.js és l'entorn que permet executar JavaScript fora del navegador, mentre que npm és l'encarregat de gestionar totes les llibreries. Quan aquests dos no es porten bé, l'ideal és no intentar «pegat» la instal·lació actual, sinó aplicar una neteja profunda i reinstal·lar usant eines que evitin que el problema torni a aparèixer en el futur.

Escollint la versió adequada: LTS o Current?

Abans de posar mà a la reparació, cal decidir quin camí prendre. La versió LTS (Suport a llarg termini) és l'aposta segura; és la que hauries de fer servir si busques estabilitat total en producció o si estàs començant, ja que està àmpliament provada i no sol donar ensurts.

D'altra banda, tenim la versió actual. Aquesta és l'avantguarda, on arriben les funcions més noves. És genial per experimentar o si necessites alguna característica capdavantera d'un framework, però tingues en compte que el suport és més curt i és on solen aparèixer més bugs o incompatibilitats amb paquets antics.

Reparació i Instal·lació a Windows 11

Quan Node.js falla a Windows, moltes vegades és per un problema de rutes. Si heu fet servir l'instal·lador .msi oficial, assegureu-vos que durant el procés es va marcar l'opció de afegir Node al PATH. Si tot i així no funciona, haureu d'anar manualment a les Propietats del Sistema i afegir les rutes de y %AppData%\npm a les variables d'entorn d'usuari.

Si prefereixes alguna cosa més moderna i neta, et recomano fer servir ala, que ja ve integrat a Windows 10 i 11. Amb una simple ordre com pots deixar-ho tot llest sense complicacions. També hi ha Chocolatey, una alternativa molt robusta per als que estimen la automatització de paquets mitjançant la línia d'ordres.

Per als que volen evitar problemes de permisos i canviar de versió sense trencar res, la salvació es diu nvm-windows. És un projecte diferent del de Linux/Mac que et permet instal·lar múltiples versions de Node i saltar entre elles amb , evitant que les eines globals es tornin inestables.

Solucions per a macOS i entorns Unix

A Mac, el camí més habitual és fer servir el paquet .pkg oficial, però si vols portar el teu flux de treball al següent nivell, Homebrew és l'eina definitiva. Permet instal·lar Node amb i mantenir-lo actualitzat fàcilment amb un , encara que de vegades hi pot haver conflictes d'enllaços que se solucionen amb l'ordre .

No obstant això, el veritable «sant grial» a macOS és nvm (gestor de versions de nodes). Quan instal·leu el Node mitjançant nvm, els fitxers es desen a la vostra carpeta d'usuari i no a directoris restringits del sistema. Això soluciona d'arrel els odiats errors de permisos EACCES, eliminant la necessitat d'usar l'ordre per instal·lar paquets globals.

Si et trobes a Linux (Ubuntu, Debian o Fedora), el més recomanable és fer servir els scripts de NodeSource per obtenir versions LTS actualitzades. Recorda que si fas servir WSL (Windows Subsystem for Linux), el millor és instal·lar Node directament dins de la distro de Linux i no barrejar el binari de Windows amb el de WSL, ja que podries generar conflictes de rutes força molestos.

Resolució d'errades comunes i manteniment

Si en escriure la terminal et deixa anar que la comanda no es reconeix, no entris en pànic. Generalment significa que el directori bin global de npm no és al teu PATH. A macOS i Linux, verifica que el teu arxiu o estigui carregant correctament la configuració de nvm en iniciar la sessió, evitant així que el error localhost es va negar a connectar-se o fallades similars de servidor local.

Per mantenir la salut del teu entorn, no n'hi ha prou amb instal·lar i oblidar. És fonamental executar de tant en tant per detectar vulnerabilitats de seguretat a les teves dependències. Si veus que alguna cosa està desfasada, us dirà quins paquets necessiten una actualització urgent.

Un truc per als desenvolupadors és utilitzar npx. En lloc d'omplir el vostre sistema d'instal·lacions globals que poden xocar entre si, npx us permet executar CLI de forma temporal. A més, si necessites gestionar pnpm o Yarn, activa Corepack amb la comanda per tenir un control total sobre els gestors de paquets.

Per deixar el sistema net abans d'una reinstal·lació, a Windows has d'esborrar no només l'aplicació des de la configuració, sinó també eliminar manualment les carpetes residuals a . A Mac, si vas fer servir Homebrew, un sol ser suficient, encara que netejar la memòria cau de npm amb sempre és una bona idea per evitar que errors antics tornin a aparèixer.

Mantenir un entorn de desenvolupament saludable passa per prioritzar sempre les versions LTS, delegar la gestió de versions a eines com NVM o FNM i evitar tant sí com no l'ús de privilegis d'administrador per instal·lar llibreries. En configurar correctament les variables d'entorn i netejar els fitxers temporals, aconseguirem que Node.js i npm funcionin amb fluïdesa en qualsevol sistema operatiu.

Article relacionat:

Solucionar Error Localhost Es va negar a connectar-se al Windows

Isaac

Redactor apassionat del món dels bytes i la tecnologia en general. M'encanta compartir els meus coneixements a través de l'escriptura, i això és el que faré en aquest bloc, mostrar tot el més interessant sobre gadgets, programari, maquinari, tendències tecnològiques, i més. El meu objectiu és ajudar-te a navegar pel món digital de forma senzilla i entretinguda.