Configurer un environnement de développement Java

Un JDK seul suffit pour compiler et exécuter Java depuis un terminal, mais pour tout projet dépassant quelques fichiers, vous aurez besoin d'un environnement de développement intégré (IDE). Un IDE vous offre l'autocomplétion, la refactorisation, un débogueur intégré et un modèle de projet qui comprend la structure des packages Java.

Ce chapitre compare les principaux IDE, présente une configuration recommandée et montre comment un projet Java typique est organisé sur le disque.

Choisir un IDE

Les trois IDE Java les plus populaires sont tous gratuits pour un usage individuel :

• IntelliJ IDEA Community Edition — l'IDE Java de JetBrains. La version Community gratuite est largement suffisante pour la plupart des apprentissages et de nombreux projets en production ; la version Ultimate payante ajoute le support de frameworks comme Spring et Jakarta EE. Recommandé pour ce livre.
• Eclipse IDE — l'IDE open source de longue date, populaire dans les grandes entreprises.
• VS Code avec l'Extension Pack for Java — plus léger qu'IntelliJ ou Eclipse, un bon choix si vous utilisez déjà VS Code pour d'autres langages.

Vous pouvez également suivre les exemples dans un éditeur de texte simple (Vim, Sublime, Notepad) et utiliser les commandes javac et java directement — les premiers chapitres de ce livre montrent les deux approches.

IntelliJ IDEA : une configuration recommandée

Si vous n'avez pas de préférence particulière, installez IntelliJ IDEA Community Edition.

1. Téléchargez depuis jetbrains.com/idea et exécutez l'installateur.
2. Lancez IntelliJ et ouvrez la boîte de dialogue New Project.
3. Choisissez Java, puis sélectionnez le JDK installé au chapitre précédent dans le menu déroulant JDK (IntelliJ le détecte généralement automatiquement ; sinon, cliquez sur Download JDK ou Add JDK).
4. Choisissez Maven ou Gradle comme système de build si vous le souhaitez, ou IntelliJ pour un projet d'apprentissage simple.
5. Cliquez sur Create.

IntelliJ ouvrira le nouveau projet, l'indexera et placera le curseur dans un fichier Main.java vide. Appuyez sur Shift+F10 (Windows/Linux) ou Control+R (macOS) pour l'exécuter.

VS Code

1. Installez VS Code.
2. Ouvrez la barre latérale Extensions et recherchez Extension Pack for Java (publié par Microsoft).
3. Installez-le. Le pack inclut le serveur de langage Java, le débogueur, le support Maven et quelques extensions associées.
4. Ouvrez un dossier contenant un fichier .java. VS Code détectera le JDK et proposera d'exécuter ou de déboguer le programme via les icônes dans la marge.

Si VS Code ne trouve pas votre JDK, définissez le paramètre java.jdt.ls.java.home sur le répertoire racine d'installation du JDK (le répertoire qui contient bin/javac).

Eclipse

1. Téléchargez le package Eclipse IDE for Java Developers depuis eclipse.org.
2. Décompressez et lancez.
3. Utilisez File → New → Java Project, donnez-lui un nom et acceptez le JDK par défaut. Eclipse crée un dossier src/ où se trouvent vos fichiers .java.

Structure du projet

La plupart des projets Java suivent une convention popularisée par Maven et adoptée par Gradle :

my-project/
├── pom.xml               # Maven build file (or build.gradle for Gradle)
├── src/
│   ├── main/
│   │   ├── java/         # production source files
│   │   │   └── com/example/MyApp.java
│   │   └── resources/    # config files, templates, properties
│   └── test/
│       ├── java/         # test source files
│       │   └── com/example/MyAppTest.java
│       └── resources/    # test fixtures
└── target/               # compiled output (gitignored)

Le répertoire src/main/java reflète la hiérarchie des packages : une classe déclarée comme package com.example; se trouve dans src/main/java/com/example/. Il ne s'agit pas d'une simple convention — le compilateur Java refuse de trouver une classe dont la déclaration package ne correspond pas à son chemin de dossier, donc la structure de répertoires et les noms de packages doivent correspondre exactement. Respectez cette organisation et chaque outil Java saura où trouver votre code.

Pour les premiers chapitres de ce livre, vous n'avez besoin de rien de tout cela — un seul fichier .java dans n'importe quel dossier suffit pour commencer.

Configurer JAVA_HOME et le PATH

Si votre IDE peut trouver java et javac depuis ses menus, vous n'avez pas besoin de toucher aux variables d'environnement. Mais dès que vous passez au terminal — ou que vous utilisez Maven, Gradle, Spring Boot ou tout outil en ligne de commande — ceux-ci ont besoin que JAVA_HOME soit défini.

JAVA_HOME est une variable d'environnement qui pointe vers la racine de votre installation JDK (le dossier qui contient bin/, lib/, etc.). Les outils de build la lisent pour localiser le compilateur et la bibliothèque standard, donc un JAVA_HOME manquant ou incorrect est la raison la plus courante pour laquelle mvn ou gradle échoue juste après l'installation.

Vérifiez votre configuration depuis un terminal :

java -version    # prints the runtime version, e.g. "openjdk 21.0.2"
javac -version   # prints the compiler version; should match the above
echo $JAVA_HOME  # on Windows: echo %JAVA_HOME%

Si java -version et javac -version rapportent des versions différentes, votre PATH et JAVA_HOME pointent vers des JDK différents — corrigez cela avant de compiler quoi que ce soit.

Consultez Comment installer Java (JDK) pour les instructions spécifiques à chaque plateforme, ou utilisez un gestionnaire de versions comme SDKMAN! qui configure JAVA_HOME par shell automatiquement.

Raccourcis clavier utiles

Les quelques raccourcis que vous utiliserez constamment dans IntelliJ :

• Exécuter — Shift+F10 (Win/Linux) / Control+R (macOS)
• Déboguer — Shift+F9 / Control+D
• Formater le fichier — Ctrl+Alt+L / Cmd+Option+L
• Correction rapide — Alt+Enter / Option+Return
• Rechercher partout — Shift Shift (double appui)
• Renommer le symbole — Shift+F6

VS Code et Eclipse ont des équivalents dans leurs menus Keymap respectifs.

Et ensuite

Vous êtes prêt à écrire du code. Le programme Java Hello World présente un premier programme complet ligne par ligne, et Comment compiler et exécuter un programme Java montre ce qui se passe sous le capot lorsque votre IDE clique sur Run.

Exercices pratiques