Un commentaire est une ligne de texte que VBA ignore complètement à l'exécution — il ne sert qu'à expliquer le code pour un humain qui le relit plus tard, y compris soi-même après plusieurs mois d'oubli.

La syntaxe

Une apostrophe ' en début de ligne (ou après du code, en fin de ligne) transforme tout ce qui suit en commentaire :

Sub CalculMarge()
    ' Cette macro calcule la marge sur chaque ligne du tableau
    Dim prixAchat As Double
    Dim prixVente As Double

    prixAchat = 12   ' prix d'achat unitaire en dollars
    prixVente = 18   ' prix de vente unitaire en dollars

    MsgBox (prixVente - prixAchat) & " $ de marge"
End Sub

Pourquoi commenter, et surtout QUOI commenter

Un commentaire utile explique le POURQUOI d'un choix, pas ce qu'une ligne fait déjà de façon évidente (i = i + 1 ' on augmente i de 1 n'apporte rien). Le meilleur moment pour commenter reste juste après avoir écrit une logique un peu subtile, pendant qu'elle est encore fraîche en tête.

Commenter (et décommenter) rapidement plusieurs lignes

Sélectionner plusieurs lignes puis utiliser les boutons Commenter le bloc / Décommenter le bloc de la barre d'outils Édition ajoute ou retire l'apostrophe sur toute la sélection d'un coup — pratique pour désactiver temporairement une portion de code pendant un test, sans la supprimer.

Exemple concret : un développeur reprend, six mois plus tard, une macro de calcul de commission qu'il avait écrite pour une association. Sans commentaires, il doit relire toute la logique pour comprendre pourquoi un seuil précis a été choisi ; avec un commentaire expliquant l'origine de ce seuil, la raison saute aux yeux immédiatement.

À vous de jouer : ajoutez des commentaires à une macro déjà écrite dans une leçon précédente, en expliquant le pourquoi d'au moins une ligne de logique conditionnelle.