Instalar Node.js en macOS y Linux falla de maneras distintas y recurrentes en 2026. Errores EACCES al escribir en /usr/local porque el prefijo global de npm quedó en un directorio del sistema. Problemas de PATH cuando el archivo de inicio del shell no carga nvm. Compilaciones de módulos nativos que fallan con «gyp: No Xcode» hasta que instalas las Command Line Tools. Macs con Apple Silicon corriendo Node de Intel a través de Rosetta cuando deberían usar ARM64 nativo. Límites de inotify en Linux que rompen webpack y vite sin avisar. Esta guía gratuita es el manual completo de diagnóstico y reparación para Unix.
Está escrita para el desarrollador que estrena una MacBook con chip M, el SRE que instala Node en una flota de servidores Ubuntu y quien lidia con el agotamiento de inotify en servidores de compilación. No damos por sentada tu experiencia con Unix: cada modo de falla trae su síntoma, el comando de diagnóstico y el arreglo preciso.
Lo que aprenderás
- Cómo se instala Node en macOS y Linux realmente, sin misterios
- El triaje de 60 segundos para aislar la capa que falló
- Elegir tu instalador: Homebrew, nvm, fnm, asdf, Volta o paquetes de la distro
- Distinguir Apple Silicon de Intel y evitar la trampa de Rosetta
- Configurar PATH y los archivos de inicio en bash, zsh y fish
- Escapar de la trampa de permisos de /usr/local sin recurrir a sudo
- Dejar listas las herramientas de compilación nativas: Xcode, gcc y python
- Resolver proxies corporativos, certificados SSL y acceso al registro
- Subir los límites de inotify y afinar el rendimiento de los watchers de archivos
- Usar Docker y dev containers, más el recetario de reinstalación limpia
Cada comando fue verificado para que sea confiable. La guía es gratuita, sin registro ni correo. Descárgala y arma un entorno de Node rápido y predecible en tu Mac o servidor Linux.
Jennifer Long –
Bought it a little skeptical, ended up recommending it to two friends. Solid, actionable content.