Extension Commentaire

Commentez et décommentez le code en utilisant la syntaxe de commentaire propre au langage, choisie automatiquement d'après le type du fichier. Les opérations de ligne agissent sur des lignes entières ; les opérations de bloc entourent une sélection de marqueurs de commentaire de bloc.

Où la trouver

Édition ▸ Commentaire :

Commande	Raccourci	Agit sur
Basculer le commentaire de ligne	Ctrl+Q (⌃Q sur macOS)	les lignes sélectionnées, ou la ligne du curseur
Commentaire de ligne	Ctrl+K	les lignes sélectionnées, ou la ligne du curseur
Décommenter la ligne	Ctrl+Shift+K	les lignes sélectionnées, ou la ligne du curseur
Commentaire de bloc	Ctrl+Shift+Q (⌃⇧Q sur macOS)	la plage d'octets sélectionnée
Décommenter le bloc	—	la plage d'octets sélectionnée

Fonctionnement

• Les commandes de ligne ajoutent ou retirent le marqueur de ligne du langage (p. ex. //, #, --) au début de chaque ligne touchée par la sélection. Basculer commente les lignes si l'une d'elles n'est pas commentée, et les décommente sinon.
• Les commandes de bloc entourent la sélection des marqueurs de bloc du langage (p. ex. /* … */, <!-- … -->) ou les retirent. Le commentaire de bloc exige une sélection non vide ; sans sélection, un avertissement s'affiche dans la barre d'état.

Les marqueurs de commentaire proviennent du type de fichier du document (d'après l'extension). Un tampon sans titre ou une extension inconnue retombe sur les marqueurs de style C (// et /* */). Si un type de fichier n'a pas de syntaxe de ligne, les commandes de ligne signalent « Aucune syntaxe de commentaire de ligne connue pour ce fichier » ; de même pour la syntaxe de bloc.

Basculer est la commande à retenir

Ctrl+Q bascule ; vous avez donc rarement besoin des commandes explicites de commentaire/décommentaire — elles existent pour forcer un sens précis.