Aller au contenu
Runbook

Installer Node.js sur macOS

Runtime JavaScript côté serveur, fondé sur le moteur V8, livré avec le gestionnaire de paquets npm.

Runtimejavascriptruntimebackendv8npm

Installation

Homebrew (dernière version) · Homebrew
brew install node

Installe la version courante de Node.js empaquetée par Homebrew, avec npm.

nvm (plusieurs versions) · Homebrew
brew install nvm
export NVM_DIR="$HOME/.nvm"
. "$(brew --prefix nvm)/nvm.sh"
nvm install --lts

Pour gérer plusieurs versions ; nécessite d'initialiser nvm dans votre shell (voir notes).

Vérifier l'installation

Vérifier
node --version

Fichiers importants

TypeCheminDescription
config~/.npmrcConfiguration utilisateur de npm (registre, proxy, jetons d'authentification).

Outils en ligne de commande

  • nodeLe runtime JavaScript.
  • npmGestionnaire de paquets Node.js.
  • npxExécute un binaire d'un paquet sans l'installer globalement.

Désinstaller

Désinstaller (Homebrew)
brew uninstall node
Désinstaller (nvm)
brew uninstall nvm
rm -rf ~/.nvm

Retirez aussi les lignes nvm de ~/.zshrc ; ~/.npmrc et les paquets globaux subsistent.

À savoir

  • Pour gérer plusieurs versions de Node.js, utilisez nvm ("nvm install --lts") ou fnm.
  • Pour une version LTS précise avec Homebrew, installez une formule versionnée comme "brew install node@24" (il n'existe pas de formule node@lts).
  • La formule "node" de Homebrew n'inclut plus Corepack ; installez-le séparément avec "brew install corepack" si vous en avez besoin, puis lancez "corepack enable".
  • Avec nvm, ajoutez son chargement à votre ~/.zshrc : "export NVM_DIR=\"$HOME/.nvm\"" puis "[ -s \"/opt/homebrew/opt/nvm/nvm.sh\" ] && . \"/opt/homebrew/opt/nvm/nvm.sh\"".

Installation sur macOS

La méthode la plus simple est Homebrew : brew install node installe le runtime et npm en une commande. Cette formule suit la version courante de Node.js, pas la LTS ; pour figer une version de support à long terme, installez une formule versionnée comme brew install node@24 (il n'existe pas de formule node@lts). Le binaire se trouve dans /opt/homebrew/bin/node sur les Mac Apple Silicon (M1 et suivants) et dans /usr/local/bin/node sur les Mac Intel. Vérifiez votre PATH si la commande node n'est pas trouvée après l'installation.

Gérer plusieurs versions

Si vos projets exigent des versions différentes de Node.js, n'installez pas le paquet Homebrew global : utilisez plutôt un gestionnaire de versions comme nvm ou fnm. Cela évite les conflits et permet de basculer par projet avec un fichier .nvmrc. nvm est une fonction shell qu'il faut sourcer : après brew install nvm, exécutez export NVM_DIR="$HOME/.nvm" puis . "$(brew --prefix nvm)/nvm.sh" avant nvm install --lts, et ajoutez ces lignes à votre ~/.zshrc pour les sessions suivantes. Notez que la formule node de Homebrew et une installation nvm peuvent entrer en conflit dans le PATH ; choisissez une seule approche.

Configuration et nettoyage

Le fichier ~/.npmrc stocke la configuration de npm (registre privé, proxy, jeton d'authentification). Les paquets installés globalement résident dans le préfixe npm (souvent /opt/homebrew/lib/node_modules). La formule node de Homebrew n'inclut plus Corepack : pour activer pnpm ou yarn, installez-le d'abord avec brew install corepack, puis lancez corepack enable. Pour désinstaller une installation nvm, lancez brew uninstall nvm, supprimez le dossier avec rm -rf ~/.nvm et retirez les lignes nvm de votre ~/.zshrc ; notez que ~/.npmrc et les paquets installés globalement subsistent.