Dès cette semaine, si le terminal ne trouve pas Java sur votre Mac, vérifiez d’abord si le JDK est installé, puis la version et le chemin que votre terminal utilise réellement. Ne réinstallez rien et ne modifiez pas les réglages système avant d’avoir comparé ces résultats aux exigences de votre cours. Ce guide porte sur Java 27 après installation, pas sur une installation suivie à l’aveugle.

Cette démarche s’adresse aux étudiants dont le terminal ne reconnaît pas java ou javac, aux débutants dont le projet appelle une version différente de celle attendue, et aux personnes qui suivent un cours sur un Mac distant.

Dernière mise à jour le 27 octobre 2026 ; vérification effectuée à partir de la documentation d’installation d’Oracle Java SE 27 pour macOS et de ses pages sur les versions et les répertoires du JDK.

01

Les premiers résultats à relever

Sur un Mac, un message « commande introuvable » est un symptôme, pas un diagnostic complet. Il peut signifier que le terminal ne sait pas où chercher le programme, que votre session utilise un environnement différent de celui d’un autre outil, ou que le JDK attendu n’est pas installé. Ces possibilités ne se règlent pas toutes de la même manière.

Avant toute modification, ouvrez le terminal que vous utilisez pour le cours et lancez :

java -version
javac -version
/usr/libexec/java_home -V

Les deux premières commandes indiquent les versions que le terminal appelle pour lancer Java et compiler du code. La dernière demande à macOS d’afficher les JDK qu’il reconnaît. La documentation d’Oracle explique comment vérifier une installation Java sur macOS et décrit l’organisation des répertoires d’un JDK.

Notez les sorties complètes, y compris le texte d’erreur. Puis comparez-les à la consigne du cours. Ne copiez pas encore de commande trouvée sur un forum et ne changez pas le chemin global de votre session : ces gestes peuvent compliquer la comparaison entre le terminal, l’éditeur et le projet.

Un exemple fréquent : vous lancez une commande dans le terminal intégré d’un éditeur et obtenez une erreur, alors que le terminal de macOS affiche une version de Java. Avant de réinstaller, vérifiez si les deux outils utilisent le même environnement. Leurs résultats ne répondent pas nécessairement à la même question.

02

Java 27 absent ou commande inaccessible

Commencez par lire ce que chaque vérification vous apprend, plutôt que de conclure à partir d’un seul message.

  • java -version affiche une version. Un lanceur Java est accessible dans cette session. Cela ne confirme pas que la version répond aux attentes du cours, ni que le compilateur javac est disponible.
  • java -version échoue, mais la liste affiche un JDK. Une installation est repérée par macOS, mais le terminal que vous utilisez ne parvient pas à appeler la commande attendue. Relevez les chemins affichés et vérifiez la configuration du terminal avant de modifier quoi que ce soit.
  • Aucun JDK pertinent n’apparaît dans la liste. Vous n’avez pas encore de preuve que le JDK demandé est installé et reconnu. Vérifiez la consigne du cours et la documentation officielle avant de télécharger une version.
  • La commande n’existe pas dans un outil, mais fonctionne dans un autre. La différence peut venir du démarrage ou des réglages de cet outil. Consignez séparément le terminal système, le terminal de l’éditeur et les informations du projet.

La documentation de Java SE 27 pour macOS fournit les instructions d’installation correspondant à cette version. Si vous confirmez que le JDK demandé manque, utilisez la procédure officielle plutôt qu’un installateur ou un script dont l’origine n’est pas vérifiée. La page de téléchargement officielle de Java permet de choisir le paquet adapté. Vérifiez la compatibilité demandée par votre cours avant de procéder : un numéro de version seul ne permet pas de déduire que toutes les consignes du projet sont identiques.

Évitez de supprimer des répertoires système, d’utiliser des privilèges administrateur sans motif documenté ou de contourner les règles d’un Mac géré par votre établissement. Si l’installation est bloquée par une restriction de l’école, demandez au responsable informatique quelle procédure est autorisée. Une erreur d’accès administré n’est pas la preuve d’un défaut Java.

03

Version du terminal et version du cours

Un Mac peut reconnaître plusieurs installations du JDK. Dans ce cas, la présence de Java 27 ne signifie pas automatiquement que chaque terminal ou projet l’utilise par défaut. La documentation d’Oracle détaille le contrôle des versions installées et la gestion de plusieurs JDK sur macOS. Elle distingue aussi l’installation et le répertoire de chaque JDK : une version peut être présente sans être celle appelée par une session donnée.

Pour savoir quel outil est utilisé, comparez trois éléments :

  • la version demandée dans les consignes ou le fichier de configuration du cours ;
  • le résultat de java -version et de javac -version dans le terminal concerné ;
  • la version affichée ou sélectionnée dans les paramètres du projet de l’éditeur.

La version affichée dans un terminal n’est pas toujours celle que le projet compile ou exécute. Un éditeur peut conserver un réglage propre au projet ; un terminal intégré peut également démarrer avec un environnement différent de celui de votre session habituelle. Pour cette raison, relevez les résultats dans chaque outil avant d’en changer un.

La chaîne de version a aussi son importance. Les champs de version et leur format ne se lisent pas comme un simple nom commercial. La documentation Oracle sur le format des chaînes de version Java aide à interpréter une sortie qui contient davantage d’informations qu’un numéro isolé. Si le cours demande une version précise, comparez l’information pertinente à sa consigne ; ne déduisez pas la compatibilité à partir d’un chiffre partiel ou d’une sortie copiée d’une autre machine.

Votre choix selon le diagnostic

Situation constatée Ce que vous pouvez conclure Prochaine décision
java et javac affichent les versions demandées Les commandes répondent dans ce terminal Passez à la compilation du programme de cours
Une version apparaît, mais elle ne correspond pas au cours Le terminal appelle Java, mais pas nécessairement le JDK attendu Vérifiez les JDK installés et la sélection du projet
java répond, mais javac échoue L’exécution et la compilation ne sont pas toutes deux confirmées Vérifiez si un JDK complet est installé avant d’examiner le chemin
La liste des JDK et les résultats varient selon l’outil Les outils ne donnent pas le même état d’environnement Comparez leurs réglages et suivez les consignes officielles de l’éditeur
Le JDK attendu est absent ou bloqué par l’école La configuration actuelle ne suffit pas à valider le cours Consultez la procédure officielle ou le support informatique

Ne corrigez pas une configuration qui fonctionne pour un autre cours avant d’avoir vérifié les exigences du projet en cours. Un changement global peut résoudre une commande et en rendre une autre inutilisable.

Si plusieurs JDK sont présents, suivez les indications du cours et de l’éditeur pour sélectionner celui qui convient au projet. Évitez de remplacer un chemin à l’échelle de tout le système simplement pour faire disparaître un message dans une seule fenêtre. Si vous ne trouvez aucune instruction fiable, gardez les sorties et demandez à l’enseignant ou au support de préciser le JDK attendu.

04

javac manquant alors que Java démarre

java et javac n’ont pas le même rôle. Le premier lance une application Java ; le second compile un fichier source. La documentation officielle décrit séparément la commande java et la commande javac. Ainsi, voir une version avec java -version ne suffit pas pour conclure que l’environnement de compilation du cours est prêt.

Lancez javac -version dans le même terminal que celui où vous avez vérifié Java, puis comparez ce résultat à la liste des JDK reconnus. Si javac échoue, ne supposez pas immédiatement que le chemin d’accès est mal réglé. Il faut d’abord savoir si un JDK comprenant le compilateur est installé et si le terminal utilise cette installation. Un lanceur accessible et un compilateur inaccessible ne prouvent pas à eux seuls quelle cause est en jeu.

Une fois les vérifications faites, appliquez la solution correspondant au résultat :

  • Le JDK demandé manque : consultez la procédure officielle d’installation et les restrictions de votre appareil.
  • Le JDK est présent, mais le terminal utilise une autre version : suivez les consignes de sélection propres au cours ou à l’éditeur.
  • Le terminal système et celui de l’éditeur divergent : vérifiez les réglages du projet et le mode de démarrage de l’éditeur.
  • Le Mac est administré par votre école : demandez si l’installation ou la modification de l’environnement est autorisée.

Ne copiez pas un chemin de répertoire dans un réglage global sans savoir à quel outil il s’applique. Une configuration d’éditeur peut être propre à un projet, tandis qu’une modification de session peut affecter d’autres exercices. Gardez une trace de l’état initial afin de pouvoir revenir à la configuration précédente si l’enseignant vous le demande.

05

Des vérifications à la validation d’un programme

Quand les résultats du terminal et du projet semblent cohérents, validez l’environnement avec un exercice simple fourni par votre cours. Si celui-ci n’en propose pas, vous pouvez créer un petit fichier Bonjour.java :

class Bonjour {
    public static void main(String[] args) {
        System.out.println("Bonjour");
    }
}

Dans le terminal où vous avez vérifié javac, compilez le fichier :

javac Bonjour.java

Puis lancez le programme :

java Bonjour

La commande de compilation doit terminer sans erreur, puis le lancement doit afficher le texte prévu. Les références de commande sont celles de la documentation Oracle sur javac et java. Cet essai confirme que ces commandes fonctionnent dans ce terminal ; il ne prouve pas à lui seul que l’ensemble du projet de cours est configuré correctement.

Si la compilation échoue, lisez le premier message d’erreur utile et vérifiez que vous êtes dans le répertoire où se trouve le fichier. Si la compilation réussit mais que le lancement échoue, vous êtes déjà au-delà du problème « commande introuvable » : examinez le message d’exécution, le nom de classe et les consignes du cours. Si le mini-programme fonctionne dans le terminal système mais pas dans l’éditeur, concentrez la suite du diagnostic sur la configuration de l’éditeur.

Fermez ensuite les fenêtres de terminal concernées et ouvrez une nouvelle session. Recommencez les contrôles de version et le programme de test. Cette vérification permet de distinguer une correction valable dans une seule session d’un environnement qui reste cohérent après redémarrage du terminal. Si le résultat change, notez quel outil a été relancé et quelles commandes ont changé de sortie.

Arrêtez le dépannage de Java lorsque les commandes et le programme de vérification fonctionnent, mais que le projet du cours échoue encore pour une raison clairement liée à son code, à une dépendance ou à un réglage propre à l’éditeur. Dans ce cas, consultez les consignes du projet ou demandez de l’aide sur ce problème précis. Si l’appareil refuse l’installation, ou si les règles de l’établissement empêchent le changement requis, adressez-vous au support informatique plutôt que de contourner ces restrictions.

06

Questions fréquentes

Pourquoi le terminal ne trouve-t-il pas Java après l’installation ?

Le message indique que la commande n’est pas accessible dans le terminal utilisé ; il ne démontre pas que le JDK est absent. Vérifiez java -version, puis consultez les JDK reconnus avec /usr/libexec/java_home -V. Comparez les résultats avant de réinstaller ou de modifier un chemin. Si un autre terminal fonctionne, examinez d’abord les différences entre les environnements.

Que faire si Java fonctionne mais que javac est introuvable ?

Java sert à lancer une application, alors que javac compile les fichiers source. La présence de l’un ne garantit donc pas que l’autre est disponible dans le même environnement. Vérifiez javac -version, la liste des JDK installés et la version demandée par le cours. N’attribuez pas automatiquement l’erreur à un chemin incorrect avant d’avoir confirmé qu’un JDK complet est installé.

Comment vérifier le JDK utilisé par mon terminal Mac ?

Lancez java -version et javac -version dans le terminal concerné ; ces commandes montrent les versions appelées. Utilisez aussi /usr/libexec/java_home -V pour consulter les installations reconnues par macOS. Comparez les résultats, puis répétez les vérifications dans le terminal intégré de votre éditeur si vous y compilez le projet.

Que faire si le cours demande une version différente de celle affichée ?

Relevez d’abord la version exigée, celle du terminal et celle indiquée par les réglages du projet. Si le Mac reconnaît plusieurs JDK, suivez la documentation du cours ou de l’éditeur pour sélectionner la version adaptée au projet. Évitez de changer la configuration générale de macOS sans consigne : vérifiez ensuite les deux commandes et validez le choix avec un programme de cours.

Si les vérifications échouent parce que vous n’avez pas accès à un environnement macOS utilisable, le problème dépasse peut-être le chemin Java. Consultez d’abord le guide VpsMesh sur les options de Mac à distance et comparez les conditions de location d’un Mac mini à la durée réelle de votre cours. Un Mac distant peut dépanner pour des exercices temporaires, mais il ne convient pas à tout le monde : une connexion stable est nécessaire, et l’accès à des périphériques physiques peut être limité. Si vous travaillez régulièrement sur des projets exigeants ou avez besoin d’un poste toujours disponible hors ligne, votre propre Mac peut être plus adapté. Le bon choix est celui qui vous laisse vérifier le JDK exigé par le cours sans contourner les restrictions de votre établissement.