Voir avec print, expliquer avec des commentaires

Le problème que nous résolvons

Vous avez écrit un programme. Vous l'avez exécuté. Le terminal n'a rien affiché.

Est-ce que cela a fonctionné ? S'est-il arrêté à mi-chemin ? Quel résultat le calcul a-t-il donné à l'intérieur ? Il n'y a aucun moyen de le savoir, car un ordinateur ne donne rien volontairement — tout ce que vous voulez voir, vous devez le demander.

print est la manière de le demander. Au début, c'est votre seule fenêtre : savoir à quel endroit le programme en est, ce qu'une variable contient, ce que l'arithmétique a produit. Les développeurs expérimentés ajoutent des appels à print dans leur code de nombreuses fois par jour, même quand ils ont un débogueur sous la main — il n'y a rien de mal à cela, ça fait partie du métier.

À la fin de ce chapitre, vous pourrez

• Afficher plusieurs éléments en un seul appel, et contrôler l'espace entre eux
• Formater la sortie avec sep et end
• Repérer la différence entre les chaînes de caractères (texte) et les nombres — pourquoi "2" + "3" n'est pas égal à 2 + 3
• Écrire des commentaires, et savoir quels commentaires valent réellement la peine d'être écrits

Prérequis : Le terminal, les dossiers et votre premier projet.

print prend plus d'une chose

Séparez autant de valeurs que vous le souhaitez par des virgules, et print les écrira toutes sur une même ligne :

print("Order", 7, "confirmed")

Order 7 confirmed

Remarquez que vous n'avez jamais tapé d'espace, pourtant les mots sont sortis espacés. print met un espace unique entre chaque valeur séparée par une virgule.

Et à la fin de chaque print, il passe à une nouvelle ligne :

print("line one")
print("line two")

line one
line two

Un print() vide produit juste une ligne vide — le moyen le plus simple pour séparer une sortie longue en groupes lisibles.

sep — l'écart, à votre façon

Si cet espace ne vous convient pas, vous pouvez le changer :

print("2026", "09", "10", sep="-")
print("home", "user", "notes.txt", sep="/")
print("a", "b", "c", sep="")

2026-09-10
home/user/notes.txt
abc

end — ce qui se passe à la fin de la ligne

Par défaut, print termine la ligne et passe en dessous. Cela est aussi modifiable :

print("Loading", end="")
print(".", end="")
print(".", end="")
print(". done")

Loading... done

Quatre appels print distincts, mais une seule ligne de sortie — car les trois premiers ont été instruits de ne rien mettre à la fin de la ligne.

Les chaînes de caractères et les nombres ne sont pas la même chose

Ces deux lignes se ressemblent énormément, mais se comportent différemment :

print(2 + 3)
print("2" + "3")

5
23

Entre guillemets, c'est une chaîne de caractères (texte), et + n'additionne pas — il concatène. Hors guillemets, c'est un nombre, et + additionne vraiment.

Cette distinction est le fondement des chapitres qui suivent, et c'est aussi la cause d'environ la moitié des erreurs que font les débutants. Pour l'instant, retenez simplement cette règle : les guillemets signifient une chaîne de caractères.

Les commentaires — les lignes que Python ne lit jamais

À partir d'un # jusqu'à la fin de cette ligne, Python ignore tout :

# Friday delivery report
total = 12 + 8
print("Total:", total)  # the sum shown at the bottom of the report

Total: 20

Les commentaires n'ont aucun effet sur le déroulement du programme. Ils sont destinés aux personnes — à votre collègue, et à vous-même dans trois mois, quand vous aurez tout oublié.

*Un bon commentaire explique le pourquoi, pas le quoi.* Ce que fait le code est visible dans le code lui-même :

# Weak: repeats what the code already says
count = count + 1  # add 1 to count

# Useful: gives the reason, which the code cannot show
count = count + 1  # the header row was counted too, so shift by one

Vous n'apprenez rien avec le premier — la ligne ajoute clairement 1. Le second explique pourquoi on ajoute 1, ce que la simple lecture du code ne permettrait pas de deviner.

Pendant l'apprentissage, les commentaires ont un autre usage : désactiver temporairement une ligne pour voir comment le programme se comporte sans elle.

print("first")
# print("second")
print("third")

first
third

Un exemple complet

Créez report.py et exécutez-le :

# A small sales report
print("=" * 24)
print("SALES REPORT")
print("=" * 24)

print("Items sold:", 3 + 5 + 2)
print("Revenue:", 3 * 120 + 5 * 90 + 2 * 250)

print()
print("Prepared by", "Rafi", sep=": ")

========================
SALES REPORT
========================
Items sold: 10
Revenue: 1310

Prepared by: Rafi

Remarquez la ligne vide après Revenue: 1310 dans la sortie : elle vient du print() vide. Elle sépare la dernière partie du rapport.

Regardez aussi "=" * 24. Multiplier une chaîne de caractères par un nombre fait répéter Python ce nombre de fois, ce qui évite de taper vingt-quatre signes égaux à la main pour tracer une ligne.

En cas de problème

SyntaxError: unterminated string literal Un guillemet a été ouvert mais jamais fermé. print("Hello) provoque cette erreur. Comptez les guillemets ouvrants et fermants.

Vous avez besoin d'un guillemet à l'intérieur d'une chaîne Utilisez un type de guillemets à l'extérieur et l'autre à l'intérieur : print("It's working") ou print('She said "yes"').

SyntaxError: Missing parentheses in call to 'print'. Did you mean print(...)? Écrire print "Hello" provoque cette erreur. C'est de la syntaxe Python 2. En Python 3, print est une fonction, il faut donc des parenthèses : print("Hello"). Cette erreur vient généralement d'un ancien tutoriel ou d'une ancienne réponse.

Donner à sep ou end une valeur sans guillemets print("a", "b", sep=-) donne SyntaxError: invalid syntax. sep et end prennent toujours une chaîne de caractères : sep="-".

Dans quelle langue écrire les commentaires ? Python accepte les commentaires dans n'importe quelle langue — tout ce qui suit # n'est pas lu par Python. Mais dans un code que vous partagez avec d'autres ou que vous utilisez au travail, écrivez vos commentaires en anglais. La raison est pratique : tout le monde sur l'équipe avec qui votre code ira ne lira pas forcément votre langue, et les messages d'erreur, la documentation et les réponses que vous trouverez en ligne sont tous en anglais. C'est pourquoi tout le code de ce cours — commentaires, noms de variables, noms de fichiers — est en anglais, et seule l'explication est dans votre langue.

À vous de jouer

Écrivez un fichier appelé profile.py qui doit produire exactement cette sortie :

------------------------
NAME : Rafi
ROLE : Python learner
------------------------
Age next year: 23

Trois conditions :

1. Les lignes du haut et du bas doivent être produites par multiplication, et non en tapant vingt-quatre tirets
2. Les lignes NAME : Rafi et ROLE : Python learner doivent utiliser sep
3. Dans la ligne Age next year, ne tapez pas le nombre vous-même — obtenez-le par addition, par exemple 22 + 1

Et placez un commentaire sur la première ligne du fichier indiquant pourquoi le fichier existe — et non ce qu'il fait.