Saltar a contenido

Plugin Comentario

Comenta y descomenta código usando la sintaxis de comentario del propio lenguaje, elegida automáticamente a partir del tipo del archivo. Las operaciones de línea actúan sobre líneas enteras; las de bloque envuelven una selección entre marcadores de comentario de bloque.

Dónde encontrarlo

Editar ▸ Comentario:

Comando Atajo Actúa sobre
Alternar comentario de una línea Ctrl+Q (⌃Q en macOS) las líneas seleccionadas, o la línea del cursor
Comentario de una línea Ctrl+K las líneas seleccionadas, o la línea del cursor
Quitar comentario de una línea Ctrl+Shift+K las líneas seleccionadas, o la línea del cursor
Comentario de bloque Ctrl+Shift+Q (⌃⇧Q en macOS) el intervalo de bytes seleccionado
Quitar comentario de bloque — el intervalo de bytes seleccionado

Cómo funciona

  • Los comandos de línea añaden o quitan el marcador de línea del lenguaje (p. ej. //, #, --) al principio de cada línea que toca la selección. Alternar comenta las líneas cuando alguna está sin comentar, y las descomenta en caso contrario.
  • Los comandos de bloque envuelven o desenvuelven la selección con los marcadores de bloque del lenguaje (p. ej. /* … */, <!-- … -->). El comentario de bloque necesita una selección no vacía; sin nada seleccionado muestra un aviso en la barra de estado.

Los marcadores de comentario vienen del tipo de archivo del documento (por extensión). Un búfer sin título o una extensión desconocida recurren a los marcadores estilo C (// y /* */). Si un tipo de archivo no tiene sintaxis de línea, los comandos de línea informan de que «No se conoce sintaxis de comentario de línea para este archivo»; lo mismo ocurre con la sintaxis de bloque.

Alternar es el que hay que recordar

Ctrl+Q alterna, así que rara vez necesitarás los comandos explícitos de comentar y descomentar: existen para cuando quieres forzar una dirección.