Когда комментарий для одного языка становится кодом для другого
Компилятор не понимает, что фрагмент «предназначен» для другой программы: он читает символы по правилам своего языка. Поэтому один и тот же участок файла может быть обычным кодом для одного компилятора и комментарием для другого.
Для этого используют различия в синтаксисе комментариев. Например, последовательность символов, которую один язык считает началом комментария, в другом может быть допустимой частью конструкции или вообще не иметь такого значения. Если дальше расположить код подходящим образом, первый компилятор пропустит его, а второй продолжит разбор. В другом участке роли могут поменяться.
Почему это работает — и где сложность
Важно согласовать не только начало комментария, но и его конец: иначе один компилятор может скрыть слишком много текста, а другой встретит ошибку синтаксиса. При этом весь файл должен оставаться корректным для каждой из целевых сред — с учётом их правил разбора и ожидаемых точек входа.
Такой файл не переводит код между языками и не заставляет один компилятор понимать другой. Это скорее тщательно спланированная раскладка: каждый инструмент видит свой участок, а чужой участок для него оказывается безвредным текстом. Поэтому при изменении даже небольшого фрагмента приходится проверять файл в обеих средах: правка, безопасная для одного языка, может нарушить границы комментария в другом.
Практическое следствие простое: общий файл возможен без отдельного генератора, но его удобство зависит от того, насколько строго согласованы правила двух парсеров.
