Przejdź do treści

Wtyczka Komentarz

Komentuj i odkomentowuj kod z użyciem składni komentarzy danego języka, dobieranej automatycznie na podstawie typu pliku. Operacje wierszowe działają na całych wierszach; operacje blokowe otaczają zaznaczenie znacznikami komentarza blokowego.

Gdzie to znaleźć

Edycja ▸ Komentarz:

Polecenie Skrót Działa na
Przełącz komentarz jednowierszowy Ctrl+Q (⌃Q na macOS) zaznaczonych wierszach lub wierszu z karetką
Komentarz jednowierszowy Ctrl+K zaznaczonych wierszach lub wierszu z karetką
Usuń komentarz jednowierszowy Ctrl+Shift+K zaznaczonych wierszach lub wierszu z karetką
Komentarz blokowy Ctrl+Shift+Q (⌃⇧Q na macOS) zaznaczonym zakresie bajtów
Usuń komentarz blokowy zaznaczonym zakresie bajtów

Jak to działa

  • Polecenia wierszowe dodają lub usuwają wierszowy znacznik danego języka (np. //, #, --) na początku każdego wiersza objętego zaznaczeniem. Przełącz komentuje wiersze, gdy którykolwiek jest nieskomentowany, a w przeciwnym razie usuwa komentarze.
  • Polecenia blokowe otaczają lub odsłaniają zaznaczenie blokowymi znacznikami danego języka (np. /* … */, <!-- … -->). Komentarz blokowy wymaga niepustego zaznaczenia; bez zaznaczenia pokazuje ostrzeżenie na pasku stanu.

Znaczniki komentarzy pochodzą z typu pliku dokumentu (według rozszerzenia). Bufor bez tytułu lub nieznane rozszerzenie korzysta ze znaczników w stylu C (// i /* */). Jeśli typ pliku nie ma składni komentarza wierszowego, polecenia wierszowe zgłaszają „Brak znanej składni komentarza wierszowego dla tego pliku”; analogicznie dla składni blokowej.

Przełączanie to skrót, który warto zapamiętać

Ctrl+Q przełącza, więc jawne polecenia komentowania/odkomentowania są rzadko potrzebne — istnieją na wypadek, gdy chcesz wymusić jeden kierunek.