多行注释很容易被破坏。如果你有以下一个简单的计算器程序?

operation = ''
print("Pick an operation:  +-*/")
# Get user input here

试着用多行注释注释它:

/*
operation = ''
print("Pick an operation:  +-*/")
# Get user input here
*/

哎呀，你的字符串包含结束注释分隔符。

来自The Zen of Python:

应该有一种——最好只有一种——明显的方法来做到这一点。

假设他们只是被认为是不必要的。由于键入#注释非常简单，多行注释可以由许多单行注释组成。

另一方面，对于HTML来说，更需要多行程序。继续输入<!——像这样的评论——>。

做一件事应该只有一种方式，这与多行字符串和单行字符串或switch/case和if的使用相矛盾，不同形式的循环。

多行注释是一个非常常见的功能，让我们面对它，多行字符串注释是一个负面影响的黑客! 我见过很多代码使用多行注释技巧，甚至编辑器也使用它。

但我想每种语言都有自己的怪癖，开发者总是坚持不去修正它。我从java方面也知道这样的怪癖，这些怪癖从90年代末就开始了，从来没有被修复过!

此外，多行注释是一个婊子。很抱歉，但是不管使用哪种语言，我只将它们用于调试目的。假设你有这样的代码:

void someFunction()
{
    Something
    /*Some comments*/
    Something else
}

然后，您发现代码中有一些东西无法用调试器修复，因此您开始手动调试，使用这些多行注释注释越来越小的代码块。这将给出函数:

void someFunction()
{ /*
    Something
   /* Comments */
   Something more*/
}

这真让人恼火。

我通过为我的文本编辑器(TextPad)下载一个宏来解决这个问题，它可以让我突出显示行，然后在每行的第一行插入#。类似的宏删除了#。有些人可能会问为什么多行是必要的，但当您为了调试目的而试图“关闭”一段代码时，它就会派上用场。