Почему комментарии в циклах ведут себя иначе, чем за их пределами?

Кажется, это очень странное поведение для меня в Tcl, или это нормально, и я просто не понимаю, как работают комментарии?

Этот код выполняется без проблем в Tcl:

#foreach corner {1 2} {
    #if { $a } {
#}

ОК, ничего на самом деле не выполняется, но ошибки нет.
Но если я закомментирую команду цикла, тогда строка комментария внутри цикла вызывает ошибку:

foreach corner {1 2} {
    #if { $a } {
}

Интерпретатор Tcl (tclsh) сообщает:

missing close-brace: possible unbalanced brace in comment
    while executing
"foreach corner {1 2} {"
    (file "test.tcl" line 1)

Для полноты картины, я должен упомянуть, что когда я удаляю эту строку комментария, ошибка исчезает.

Это нормально?
Существует ли лучший способ “закомментировать” строки при разработке кода? Как можно сделать так, чтобы интерпретатор полностью игнорировал содержимое в комментариях?

В Tcl, { ... } это не блок кода – это строковый литерал, такой же, как "...", только с другими правилами для “специальных символов” (без подстановки переменных и т.д.).

Например, эти два фрагмента эквивалентны:

• foreach corner {1 2 3} {puts $corner}
  

• foreach corner "1 2 3" "puts \$corner"
  

• set foo {puts $corner}
  foreach corner {1 2 3} $foo
  

В отличие от традиционных строк с ", в которых нужно экранировать каждую вложенную кавычку (как в "abc\"def"), одно из правил внутри строки {} заключает в том, что она может содержать неэкранированные фигурные скобки, если они сбалансированы; т.е. } не обязательно завершает строку, если парсер до этого видел некоторое количество {. Таким образом, можно иметь:

• tclsh% set foo {one two {three four {five} six} seven}
  tclsh% lindex $foo 2
  three four {five} six
  

• по сравнению с:

  tclsh% set foo "one two \"three four \\\"five\\\" six\" seven"
  tclsh% lindex $foo 2
  three four "five" six
  

Однако в парсере нет правила о # комментариях внутри строкового литерала: это просто ещё один обычный символ в строке.

• set foo {one {two} #three four}
  

• set foo {
      one {two}
      #three four
  }
  

Это станет комментарием позже, когда строка будет исполнена как тело цикла (в этот момент её содержимое будет распознано заново), но сейчас # ничего не значит для внешнего парсера и каждое { и } в этой строке по-прежнему учитывается.

Поэтому, если у вас есть несбалансированная { внутри строки {}, вам, возможно, нужно временно изменить её на \{. (Обратная косая черта на самом деле становится частью значения строки, но в данном случае она не причинит вреда.)