Création de votre premier projet dans IntelliJ IDEA

1. Création d’un nouveau projet étape par étape

Un projet dans IntelliJ IDEA — ce n’est pas simplement un dossier avec des fichiers, mais un conteneur complet dans lequel l’IDE stocke tout ce qui est lié à votre futur programme. Un projet contient :

• le code source (fichiers avec l’extension .java) ;
• les paramètres du projet (par exemple, la version de Java à utiliser) ;
• les bibliothèques externes (si nécessaire) ;
• des fichiers et ressources auxiliaires.

À l’intérieur du projet, il y a généralement un dossier src — l’emplacement principal de vos fichiers Java. Tout ce qui ne concerne pas le code est stocké séparément et ne gêne pas le travail.

Lancement d’IntelliJ IDEA

Sur l’écran de démarrage, cliquez sur le grand bouton bleu New Project.

Configuration des paramètres du projet

Passons en revue les champs principaux de haut en bas :

• Name: le nom de votre projet. Ce nom sera également utilisé pour créer le dossier sur le disque.
• Location: le chemin où le projet sera stocké sur l’ordinateur. Par défaut, IDEA propose son dossier IdeaProjects. Laissons tel quel.
• Create Git repository: permet d’initialiser immédiatement le système de contrôle de versions Git pour le projet. À ce stade, pour ne pas compliquer, laissez cette case décochée.
• Build system: le système de build — c’est l’outil qui automatise la compilation du code, la gestion des dépendances et la création de l’application prête à l’emploi :
  • IntelliJ: système de build intégré d’IDEA. Notre choix.
  • Maven/Gradle: systèmes de build puissants et indépendants, 99 % des projets réels utilisent l’un des deux.
• Add sample code: IDEA créera automatiquement pour nous la structure de base du projet et une classe avec la méthode main.

Installation du JDK depuis IntelliJ IDEA

Nous arrivons maintenant à l’étape d’installation du JDK.

• Comme nous ne l’avons pas encore installé, la liste sera vide. Notre objectif est de le télécharger directement depuis ici.

1. Cliquez sur la liste déroulante et choisissez l’option Download JDK...

2. Une petite fenêtre s’ouvre :

• Version: choix de la version de Java. Notre cours prend en charge la version 25.
• Vendor: le fournisseur du distributeur. Comme convenu précédemment, choisissez Amazon Corretto.
• Location: le chemin où IDEA téléchargera et installera ce JDK. Vous pouvez laisser la valeur par défaut.

3. Cliquez sur le bouton Select.

Tous les paramètres sont définis. Cliquez sur Create.

IntelliJ IDEA va télécharger le JDK sélectionné, puis créer la structure du projet et ouvrir la fenêtre principale de l’éditeur. Il faudra patienter quelques minutes.

Au premier lancement, vous pouvez voir en bas à droite une notification d’IDEA vous proposant de configurer votre antivirus, par exemple « Microsoft Defender may affect IDE performance ». Cliquez sans hésiter sur le bouton Exclude folders. IntelliJ IDEA ajoutera automatiquement le dossier du projet et ses dossiers système à la liste des exclusions de votre antivirus.

Au premier lancement du programme, vous verrez une bannière annonçant l\'activation de la période d\'essai gratuite d\'Ultimate. C\'est l\'accueil standard dans la nouvelle version unifiée d\'IntelliJ IDEA.

Cette notification confirme simplement que vous avez désormais un accès temporaire à Ultimate, mais pour notre cours, c\'est un ajout facultatif.

2. Aperçu rapide d’IDEA

Nous avons donc créé un nouveau projet. Voyons ce que nous avons sous les yeux.

1. Project — la fenêtre principale pour naviguer dans la structure du projet.

2. Le fichier actuellement ouvert Main.java

3. Les boutons pour Run ▶ (exécution) et Debug (débogage) du programme

4. Le menu latéral

• Services — l’onglet sert à gérer les services externes, au début vous n’en aurez pas besoin.
• Terminal — la ligne de commande (console) de votre système d’exploitation (Windows, macOS, Linux), intégrée directement dans l’IDE.
• Problems — le panneau affiche les erreurs de compilation et les avertissements pendant que vous écrivez le code. IDEA analyse votre code à la volée et souligne les zones problématiques, en proposant souvent des corrections automatiques.
• Git — une icône en forme de diagramme ramifié. Ce panneau est destiné au travail avec le système de contrôle de versions Git.

3. Structure du projet

Regardons de plus près la fenêtre de structure du projet à gauche. IntelliJ IDEA a créé pour nous plusieurs dossiers et fichiers importants.

• .idea - c’est le dossier technique d’IntelliJ IDEA. Il contient des paramètres spécifiques à ce projet.
  Il ne faut pas modifier ce dossier manuellement ni l’envoyer à d’autres développeurs. Il est propre à chaque utilisateur.
• src - le dossier le plus important dans tout projet Java. Le nom est l’abréviation de « sources ». C’est ici que se trouvera tout votre code.
  • Main.java puisque nous avons coché « Add sample code », IDEA a créé ce fichier pour nous. C’est une classe Java avec le « point d’entrée » du programme — la méthode public static void main(String[] args). C’est à partir d’elle que commence l’exécution de toute application Java.
• .gitignore - c’est un fichier de configuration pour le système de contrôle de versions Git.
• External Libraries - ce n’est pas un dossier réel, mais une représentation virtuelle de toutes les bibliothèques externes connectées au projet. Pour l’instant, il n’y en a qu’une, mais la plus importante — notre JDK.

4. Exécution du programme

Le plus agréable — lancer le programme et voir le résultat de votre travail (et pas seulement des erreurs).

En haut de la fenêtre, cliquez sur le bouton Run ▶. À sa gauche figure le nom du fichier qui sera exécuté (dans notre cas Current File):

Alternative : clic droit sur le fichier ▶ Run Run 'Main.main()'.

Vous verrez le résultat de l’exécution du programme

Commande de lancement (en rouge) — c’est la commande qu’IntelliJ IDEA a formée et transmise au système d’exploitation pour démarrer le programme.

Il s’agit d’un appel direct au fichier exécutable java.exe du JDK que nous avons téléchargé. C’est ce fichier qui lance la machine virtuelle Java (JVM). Tout le reste de la ligne après java.exe correspond à des paramètres techniques.

Sortie du programme (en bleu) — c’est le résultat utile de l’exécution de votre code.

Code de sortie (en vert) Process finished with exit code 0. Ce message est le rapport final indiquant comment le programme s’est terminé.

• Par convention, exit code 0 signifie que le programme a exécuté toutes ses instructions du début à la fin et s’est terminé normalement, sans aucune erreur.
• Tout autre code indique qu’une erreur s’est produite pendant l’exécution.

Faites toujours attention à cette ligne. C’est votre principal indicateur pour savoir si votre programme a « planté » ou s’est terminé correctement.

De plus, après la première exécution, un nouveau dossier out est apparu dans la structure du projet à gauche. Il contient les fichiers compilés .class — le bytecode exécuté par la JVM.

Félicitations ! Vous venez d’écrire et d’exécuter votre premier programme Java dans un IDE professionnel.

Comment fonctionne le lancement d’un programme dans IDEA

Lorsque vous cliquez sur Run, il se passe ceci :

1. IDEA compile votre code — transforme les .java en .class (bytecode pour la JVM).
2. La JVM démarre — la machine virtuelle Java commence l’exécution du programme à partir de la méthode main.
3. Le résultat s’affiche — tout ce qui est écrit via System.out.println apparaît dans la console.

Toute cette magie se produit en quelques clics — inutile d’appeler manuellement le compilateur ni de chercher où le fichier a été enregistré.

5. Raccourcis clavier IntelliJ IDEA

IntelliJ IDEA propose des raccourcis clavier pour la plupart des commandes liées à l’édition, à la navigation, au refactoring, au débogage et à d’autres tâches. Mémoriser ces raccourcis vous aidera à travailler plus efficacement sans quitter le clavier.

Vous pouvez consulter les combinaisons de raccourcis dans la documentation JetBrains, avec la possibilité de choisir votre OS.

Ou les afficher directement dans IDEA. Menu → Help → Keyboard Shortcuts PDF.

6. Erreurs lors de la création du premier projet

Fichier Java créé en dehors du dossier src

Dans le monde Java, il existe une règle d’or : le dossier src — c’est la racine d’où « poussent » toutes les sources de votre projet. L’environnement de développement et les systèmes de build s’attendent à y trouver le code.

Discordance entre les noms de la classe et du fichier
Le fichier doit porter le même nom que la classe (en respectant la casse !). Par exemple, Main.java pour la classe Main. Si vous nommez le fichier main.java (avec une minuscule), le compilateur ne sera pas content.

Méthode main manquante ou mal écrite
La méthode doit être exactement public static void main(String[] args). Une seule faute de frappe — et le programme ne démarrera pas.

JDK non sélectionné pour le projet
Si lors de la création du projet aucun JDK n’est sélectionné, ou si le chemin choisi est incorrect, IDEA ne pourra pas compiler le projet. Vérifiez les paramètres via File → Project Structure → Project SDK.

Espaces et cyrillique dans le chemin
Bien que les systèmes modernes soient devenus beaucoup plus tolérants, la règle d’or reste valable : les chemins vers les projets et vers le JDK ne doivent pas contenir de cyrillique, d’espaces ou de caractères spéciaux. Mieux vaut utiliser uniquement des lettres latines et des underscores.

Exécution de la mauvaise classe
Si vous avez plusieurs classes avec la méthode main, assurez-vous d’exécuter le bon fichier (clic droit → ▶ Run).