Votre terminal ne reconnaît pas node, ou votre premier fichier JavaScript ne démarre pas ?
Solution rapide : si votre cours n’impose pas une autre version, choisissez Node.js 24, encore indiqué comme version LTS dans les informations officielles consultées, installez-le depuis le site de Node.js, puis vérifiez node et npm avant de lancer un petit programme. Si le cours précise une version différente, suivez d’abord cette consigne plutôt que de remplacer votre environnement. Le tableau des versions de Node.js permet de contrôler leur statut.
Ce guide s’adresse aux étudiants qui apprennent JavaScript et n’ont pas encore préparé Node.js sur leur Mac.
Il convient aussi si vous devez utiliser un ordinateur d’établissement ou un Mac soumis à une politique informatique.
Si vous avez déjà un projet, vous pourrez distinguer un problème d’installation d’un problème de version ou de dossier.
SECTION 01Choisir la bonne installation avant de télécharger
Node.js est l’environnement qui exécute du JavaScript en dehors d’un navigateur. Pour vous représenter les outils : Node.js est l’atelier où votre programme fonctionne, et npm est le service qui aide à trouver et gérer des outils supplémentaires pour ce travail. La documentation officielle décrit npm comme un gestionnaire de paquets pour Node.js. La présentation de npm précise son rôle.
Pour un exercice de cours sans version imposée, Node.js 24 est un choix raisonnable parce que la page officielle des versions le classe comme LTS, tandis que Node.js 26 y apparaît comme Current. Ces statuts peuvent évoluer : vérifiez la page au moment de l’installation plutôt que de retenir une règle valable indéfiniment. Pour un projet déjà commencé, la consigne pédagogique et les fichiers du projet passent avant la préférence pour une version plus récente. Le tableau officiel des versions est la référence pour cette vérification.
| Votre situation | Choix à privilégier | Vérification avant de continuer |
|---|---|---|
| Vous débutez et le cours ne fixe aucune version | Node.js 24, si son statut LTS est toujours confirmé | Le statut sur la page officielle et le programme d’installation proposé pour votre Mac |
| Le cours indique une version précise | La version demandée par l’enseignant ou le projet | La version mentionnée dans la consigne et dans les fichiers du projet |
| Vous utilisez un Mac administré par un établissement | La méthode autorisée par l’établissement | Les règles d’installation et les outils fournis par l’école |
| Vous avez déjà un projet et les commandes échouent | Vérifier l’installation et l’emplacement du terminal avant toute modification | Les réponses de node -v, npm -v et le dossier du projet |
Le site officiel de Node.js présente les téléchargements et les choix disponibles pour les plateformes prises en charge. Sélectionnez la version et le programme adaptés à votre Mac sur cette page, au lieu de télécharger un fichier depuis un site tiers ou de suivre une ancienne capture d’écran. La page officielle des téléchargements Node.js est la référence à suivre.
| Méthode de préparation | Avantage | Limite à connaître |
|---|---|---|
| Installation proposée sur le site officiel de Node.js | Vous partez des fichiers et indications publiés par le projet Node.js | Vous devez choisir la version correspondant au cours et à votre Mac |
| Environnement fourni par l’établissement | Il peut respecter les règles et la configuration du cours | Vous dépendez de ce que l’établissement autorise ou met à disposition |
| Mac distant autorisé | Vous pouvez travailler sur un Mac distinct de votre ordinateur personnel | Le transfert des fichiers, la connexion et le terminal doivent viser le même environnement |
Un programme d’installation fourni par une source officielle réduit le risque de partir d’un fichier modifié ou d’une instruction dépassée. Il ne garantit toutefois pas que la version conviendra à chaque cours : vérifiez cette exigence avant de lancer l’installation.
SECTION 02Préparer l’installation sans modifier les réglages protégés
Avant d’installer, ouvrez la consigne du cours et repérez toute mention de Node.js, de npm, d’une version ou d’un fichier de configuration du projet. Si le cours utilise déjà un dépôt de code, consultez ses consignes avant de mettre à jour un environnement qui fonctionne. Une version plus récente n’est pas automatiquement la meilleure pour reproduire un exercice préparé avec un autre environnement.
Sur un ordinateur personnel, assurez-vous que vous installez le logiciel depuis la page officielle et que vous savez où retrouver le fichier téléchargé. Sur un Mac d’école ou géré par une organisation, vérifiez d’abord si vous êtes autorisé à installer des logiciels. Si l’installation est bloquée par une règle administrative, ne contournez pas la restriction et ne modifiez pas les réglages protégés : demandez quelle méthode l’établissement autorise.
| Où vous travaillez | Avant d’installer | Si vous n’avez pas les droits nécessaires |
|---|---|---|
| Mac personnel | Confirmez la version requise et choisissez l’installation officielle | Arrêtez-vous si macOS demande une autorisation que vous ne pouvez pas accorder |
| Mac de l’établissement | Consultez les règles et les consignes du cours | Demandez un environnement fourni ou approuvé par l’établissement |
| Mac accessible à distance | Confirmez comment vous vous connectez et où se trouvent les fichiers | Utilisez seulement un accès autorisé et gardez le projet dans l’environnement prévu |
Cette préparation évite une erreur fréquente : installer correctement Node.js sur une machine, puis essayer d’exécuter le projet depuis le terminal d’une autre. L’ordinateur où se trouve le fichier, celui où le terminal s’exécute et celui où Node.js est installé doivent correspondre.
SECTION 03Installer et vérifier les deux commandes
Comment contrôler si Node.js et npm sont déjà installés sur votre Mac ? Ouvrez Terminal et saisissez node -v, puis npm -v. Ces commandes demandent à chaque outil d’afficher sa version. Si vous obtenez une réponse pour les deux, cela montre que les commandes sont accessibles depuis ce terminal ; cela ne prouve pas encore que le projet utilise la version attendue par votre cours. Pour comprendre les versions de npm, consultez la documentation officielle sur les versions de npm.
Procédez ensuite dans cet ordre :
- Lisez la consigne du cours. Notez la version demandée si elle est indiquée. Si elle ne l’est pas, vérifiez sur la page officielle que Node.js 24 est toujours classé LTS avant de la choisir.
- Ouvrez le site officiel de Node.js. Dans la rubrique des téléchargements, choisissez la version retenue et l’option correspondant à votre Mac. Les fichiers et les choix proposés pouvant évoluer, suivez les indications actuelles de la page plutôt qu’un ancien tutoriel. Les téléchargements officiels de Node.js donnent accès aux options publiées.
- Lancez l’installation autorisée. Suivez les indications du programme obtenu depuis le site officiel. Si le Mac de votre établissement bloque l’installation ou demande un droit d’administration que vous ne possédez pas, arrêtez-vous et contactez l’établissement au lieu d’essayer de contourner le blocage.
- Fermez puis rouvrez Terminal. Cela permet de vérifier la commande dans une nouvelle session, sans modifier les réglages du shell. Si le résultat reste inattendu, ne copiez pas au hasard des commandes de modification de chemin trouvées en ligne.
- Contrôlez les deux outils. Exécutez
node -v, puisnpm -v. Comparez la version de Node.js avec la consigne ; notez séparément le résultat de npm. Les deux commandes n’indiquent pas la même chose : l’une contrôle l’environnement d’exécution, l’autre le gestionnaire de paquets. - Lancez le test minimal ci-dessous. Si le terminal affiche le texte prévu, Node.js sait exécuter ce fichier. Si vous obtenez une erreur, gardez son message exact : il aidera votre enseignant ou le support informatique à identifier le problème.
La séquence de test reprend le principe documenté par Node.js pour lancer un fichier JavaScript depuis la ligne de commande. L’exemple officiel d’exécution avec Node.js montre comment invoquer l’exécutable avec un fichier.
console.log("Mon premier programme fonctionne.");
Enregistrez ce contenu dans un fichier nommé premier.js, puis ouvrez le terminal dans le dossier où se trouve le fichier et exécutez :
node premier.js
Le résultat attendu est le texte Mon premier programme fonctionne.. Ici, le dossier du projet est simplement le dossier où vous rangez les fichiers de votre exercice, comme un dossier de devoirs. Le terminal doit se trouver dans ce même dossier pour que la commande repère premier.js. Si vous voyez le texte, vous avez validé l’exécution de base ; cela ne signifie pas encore que toutes les dépendances d’un projet de cours sont installées.
Node.js 24 est installé, mais la commande node reste introuvable : que faire ? Commencez par fermer puis rouvrir Terminal et refaites le test. Si la commande reste inconnue, vérifiez que l’installation a réellement été achevée et que vous avez choisi la version voulue sur la page officielle. Si vous avez installé le logiciel sur un autre Mac ou dans un environnement distant, la commande exécutée localement ne peut pas vérifier cette autre machine. N’éditez pas les fichiers de configuration du shell sans consigne officielle ou aide de votre établissement ; si le problème persiste, transmettez le résultat affiché au support.
SECTION 04Adapter la marche à suivre à votre situation
Vous commencez un cours sans projet existant
Pour un premier exercice, installez la version recommandée par l’enseignant ; si le cours ne fixe aucun choix et que la page de Node.js confirme encore le statut LTS, Node.js 24 peut servir de point de départ. La distinction est utile : « installé » signifie que les commandes répondent, tandis que « adapté au cours » signifie que la version correspond aux attentes pédagogiques.
Créez le fichier minimal dans un dossier facile à retrouver, puis exécutez-le depuis Terminal. Ne commencez pas en ajoutant des bibliothèques avec npm : ce serait une étape supplémentaire sans intérêt tant que vous n’avez pas vérifié que Node.js exécute un fichier simple.
Votre projet existe déjà et son exécution échoue
Vérifiez d’abord la consigne du projet, puis comparez la version annoncée par node -v avec celle qui y est demandée. Vérifiez aussi npm -v séparément : un résultat pour npm ne prouve pas que le dossier ouvert est le bon ni que le programme du cours est correctement installé.
Examinez ensuite le dossier courant dans Terminal et confirmez que c’est celui où se trouvent les fichiers du projet. Si vous avez ouvert le terminal dans un autre dossier, revenez à l’emplacement du projet par la méthode indiquée dans votre cours ou votre éditeur. Si les commandes répondent mais que le projet échoue, conservez le message d’erreur complet et demandez de l’aide avant de remplacer la version ou de supprimer des fichiers. Cette démarche protège les travaux déjà commencés.
Votre école empêche l’installation
Un Mac d’école interdit l’installation : comment continuer à travailler sur votre projet Node.js ? Ne cherchez pas à contourner la restriction. Demandez à l’enseignant ou au service informatique si l’école fournit un environnement déjà préparé, autorise un outil de pratique dans le navigateur ou permet l’accès à un Mac distant. Le choix dépend des règles du cours et de l’établissement.
Si une solution distante est autorisée, vérifiez avant de commencer où le projet doit être enregistré et quel terminal exécute les commandes. Le fichier peut être visible sur votre Mac personnel alors que le terminal distant ne le voit pas ; dans ce cas, Node.js peut fonctionner correctement, mais pas sur le fichier que vous vouliez lancer. Confirmez l’emplacement du projet après la connexion et utilisez un transfert de fichiers approuvé par votre école. Les travaux contenant des données personnelles ou des informations de cours ne doivent pas être envoyés vers un service non autorisé. Pour examiner les informations générales sur l’accès à un Mac distant, vous pouvez consulter la présentation de MACNOX, puis vérifier avec votre établissement si cet usage est permis.
Le navigateur peut convenir pour des exercices simples si le cours le permet, mais il ne reproduit pas nécessairement le dossier, les outils ou les règles de votre projet local. Avant d’y déplacer tout votre travail, testez un exercice sans données sensibles et vérifiez que la méthode est acceptée par l’enseignant.
SECTION 05Utiliser VS Code pour exécuter votre premier fichier
VS Code est l’éditeur dans lequel vous écrivez et parcourez vos fichiers ; Node.js est l’outil qui exécute votre programme. Installer l’un ne remplace donc pas l’autre. Pour préparer VS Code sur Mac, suivez les consignes de la documentation officielle d’installation pour macOS. La documentation de VS Code décrit également les composants liés à Node.js et JavaScript : les composants complémentaires de VS Code.
Ouvrez dans VS Code le dossier qui contient premier.js, puis ouvrez un terminal intégré. Vérifiez que ce terminal correspond bien à l’environnement où vous venez de contrôler Node.js. Saisissez node -v dans ce terminal : si vous obtenez le même résultat que dans Terminal, les deux sessions trouvent une installation accessible. Ensuite, exécutez node premier.js. L’objectif de ce premier essai n’est pas d’apprendre la syntaxe JavaScript, mais de confirmer que le dossier, l’éditeur et l’environnement d’exécution sont raccordés.
Après l’installation, comment lancer un premier programme avec VS Code ? Créez ou ouvrez un fichier JavaScript dans le dossier du projet, ajoutez le console.log ci-dessus, puis lancez-le dans le terminal intégré avec node premier.js. Le résultat doit apparaître dans ce terminal. Si VS Code affiche un dossier différent de celui où vous avez enregistré le fichier, corrigez d’abord l’emplacement ouvert ; ne réinstallez pas Node.js pour un simple décalage de dossier.
| Résultat du test | Ce que vous pouvez conclure | Action suivante |
|---|---|---|
node -v et npm -v répondent, et le fichier affiche le texte prévu |
Les deux commandes sont accessibles et le test minimal s’exécute | Comparez la version avec celle du cours avant de poursuivre |
node -v répond, mais npm -v échoue |
Les deux outils ne sont pas tous deux validés | Notez les messages exacts et consultez la documentation ou le support |
| Les commandes répondent, mais le fichier est introuvable | Le problème peut venir du dossier courant ou du nom du fichier | Vérifiez où le fichier est enregistré et quel dossier est ouvert |
Le terminal ne reconnaît toujours pas node après une nouvelle ouverture |
L’installation ou son accès depuis ce terminal n’est pas confirmé | Arrêtez les changements de configuration et demandez une aide adaptée |
SECTION 06Choisir la suite sans perturber votre cours
La vérification finale est simple : votre version correspond à la consigne, node -v et npm -v répondent dans l’environnement prévu, et node premier.js affiche le texte attendu. Pour un projet déjà fourni, ajoutez une dernière vérification : les commandes sont lancées depuis le dossier de ce projet, et non depuis un autre emplacement.
Installer au hasard une version plus récente peut compliquer la reproduction d’un exercice ; ignorer le dossier courant peut faire croire à une panne d’installation ; et contourner les restrictions d’un ordinateur d’école peut enfreindre ses règles. Avant de demander de l’aide, préparez la version demandée par le cours, les réponses des deux commandes et le message d’erreur complet. Ces éléments permettent de décrire précisément le blocage sans multiplier les changements risqués.
Si votre ordinateur actuel vous oblige à alterner entre un navigateur limité, une machine d’école verrouillée et des copies de fichiers entre plusieurs environnements, un Mac accessible à distance peut être une solution ponctuelle, à condition que votre cours l’autorise. Il ne supprime pas les contraintes de connexion, de transfert ni de conformité, et il n’est pas forcément pertinent pour un usage régulier et durable : dans ce cas, comparer l’accès distant à un Mac personnel peut être plus judicieux. Vous pouvez consulter les informations de location de MACNOX pour évaluer cette option, puis décider selon les exigences de votre cours et l’emplacement de vos fichiers.