让我们把这些最好的想法和建议结合起来。

alias _CommentBegin_=": <<'_CommentEnd_'"

如前所述，单引号是非常重要的，因为没有它们 $(commandName)和${varName}将被计算。

你可以这样使用它:

_CommentBegin_
echo "bash code"
or 
none code can be in here
_CommentEnd_

别名使使用更加明显和更好看。

你可以使用Vi/Vim的可视块模式，它是为这样的东西设计的:

Ctrl-V  
Highlight first element in rows you want commented  
Shift-i  
#  
esc  

不加评论的是:

Ctrl-V  
Highlight #'s  
d  
l  

这是vi做这类事情的交互式方式，而不是计算或读取行号。

最后，在Gvim中使用ctrl-q进入Visual Block模式，而不是ctrl-v(因为这是粘贴的快捷键)。

我喜欢单线开闭:

if [ ]; then ##
    ...
    ...
fi; ##

“##”可以帮助我轻松地找到块注释的开始和结束。我可以在“##”后面加上一个数字，如果我有很多的话。要关闭注释，我只需在“[]”中插入一个“1”。我还避免了在注释块中使用单引号时遇到的一些问题。

在bash中:

#!/bin/bash
echo before comment
: <<'END'
bla bla
blurfl
END
echo after comment

END分隔符周围的“和”很重要，否则块内的内容(例如$(命令))将被解析并执行。

关于解释，请看这个和这个问题。

sunny256给出的已接受的答案中的here-doc技巧的一个变体是使用Perl关键字进行注释。如果您的注释实际上是某种文档，那么您可以开始在注释块中使用Perl语法，这允许您将其打印出来，将其转换为手册页，等等。

就shell而言，你只需要将'END'替换为'=cut'。

echo "before comment"
: <<'=cut'
=pod

=head1 NAME
   podtest.sh - Example shell script with embedded POD documentation

etc.

=cut
echo "after comment"

(参见“在shell脚本中嵌入文档”)

在vscode中ctrl+K+C (ctrl+K+U取消注释)。