formatting в Java

Расположите код так, чтобы читатель сразу видел блоки и операторы. В Yard.java оставьте public-класс Yard. Внутри main сделайте отступ строк тела, напишите int sum = 10 + 2; с пробелами вокруг = и +, затем напечатайте sum. Скомпилируйте через javac Yard.java и запустите java Yard. Экран должен показать 12. Даты оставьте следующей странице — этот урок про пробелы и отступ (indent), а не про календарные типы.

Отступ внутри фигурных скобок

Страница именования доказала точные написания. Эта страница доказывает аккуратную раскладку. Откройте Yard.java. Держите имя public-класса Yard. Удалите оставшиеся демо ticketCount / TicketCount, если они хоронят историю форматирования, оставшиеся файлы только с Javadoc вокруг add, охоты за метками отладки и любой клавиатурный Scanner. Программа не должна ждать ввода. Строка import не нужна.
Напишите класс и main с фигурными скобками, которые помечают блок. Операторы, которые принадлежат main, сдвиньте на один уровень глубже строки main. Частая привычка новичка — четыре пробела на уровень. В этой демо держите ту же ширину на каждой строке с отступом.
Оставляйте пробелы вокруг присваивания и плюса, чтобы глаз отделял имена от операторов:
int sum = 10 + 2;
Затем напечатайте результат:
System.out.println(sum);
Форматирование не меняет математику. Десять плюс два по-прежнему двенадцать. Отступ и пробелы помогают человеку увидеть, какие строки сидят внутри main.

Из папки, где лежит Yard.java, запустите javac Yard.java. Когда скобки, фигурные скобки и точки с запятой совпадают, javac не пишет собственной строки. Затем запустите java Yard — не java Yard.java. Уберите окончание .java из команды запуска. Держите один public-класс в файле, чтобы имя совпадало с Yard.
Экран показывает 12. Пройдите запуск один раз. Java начинает с Yard.main. Строки с отступом — это тело. Присваивание кладёт двенадцать под sum. Печать пишет 12. Если убрать пробелы вокруг = и всё же скомпилировать, результат может остаться 12 — пробелы были для читателей. Если убрать нужные фигурные скобки или сломать структуру, javac жалуется. Эта страница намеренно держит полную, читаемую форму.
Произнесите правило, глядя на экран: сделайте отступ тела, расставьте пробелы у операторов, которые глаза должны поймать, затем скомпилируйте и запустите, чтобы доказать, что программа всё ещё работает. Не изобретайте API даты и времени на этой странице. Даты ждут следующего урока.
Если вы всё ещё видите 4, затем 9 из файла именования, переключитесь на учебный файл форматирования и снова запустите java Yard. Если каждая строка сидит в нулевом столбце без indent, программа может всё ещё запуститься, но границы блока читать труднее. Держите отступ в учебном файле.

Короткий чек-лист форматирования

Чек-лист ниже — короткая карта этой страницы. Сначала вы делаете отступ тела. Затем оставляете пробелы вокруг ясных операторов. Затем проверяете через javac и java Yard. Не гадайте, что пробелы меняют сумму. Не удаляйте весь отступ, пока не знаете, что экран всё ещё показывает 12.

Держите таблицу рядом с учебным файлом, пока редактируете. Укажите на открывающую скобку main, затем на строку sum с отступом, затем на закрывающую скобку. Эта игра сопоставления — вся идея новичка за один проход. Инструменты, которые позже форматируют автоматически, следуют похожим привычкам. Люди пользуются той же картой, когда файл растёт.
Если рядом ещё лежат демо именования, оставьте их как историю. Для этого урока запускайте учебный файл форматирования, чтобы экран показал аккуратную сумму, а не пару чувствительности к регистру. Если javac жалуется на дублирующие public-классы, держите public только у Yard.

Форматирование — это не математика

Переполненная строка всё ещё может посчитать ту же сумму. int sum=10+2; без пробелов может скомпилироваться и напечатать 12. Эта страница всё равно учит пробелам, потому что читатели меньше устают, когда операторы заметны. Отступ — та же идея для блоков: компилятору важны фигурные скобки; читателю важно видеть, какие строки принадлежат вместе.
Не считайте форматирование вторым языком программирования. Держите один ясный стиль в учебном файле. Не смешивайте табы и пробелы так, чтобы строки прыгали. Четырёх пробелов на уровень достаточно для этой формы новичка.
Когда раскладка неверна, но токены верны, javac всё ещё может пройти. Поэтому читайте скобки и отступ вместе, а не только число на экране.

Сравнение с написаниями именования

На странице именования ticketCount и TicketCount были разными именами. На этой странице пробелы и отступ не создают новых имён. Они располагают те же имена и операторы так, чтобы блок был очевиден. Вы по-прежнему компилируете Yard.java и запускаете java Yard. Новая привычка — единый отступ внутри фигурных скобок плюс читаемые пробелы вокруг операторов.
Именование ответило, какое написание искать. Форматирование отвечает, как файл должен выглядеть, пока вы смотрите. Держите обе привычки позже. Этот урок изолирует раскладку, чтобы экран доказал сумму после аккуратной правки.
Если ещё открыт оставшийся файл именования, вы можете увидеть 4 и 9. Переключитесь на файл форматирования, чтобы main печатал sum как 12. Держите демо дат вне этой страницы. Держите клавиатурный ввод вне этой страницы.

Перед датами

Вы можете сделать отступ main, расставить пробелы вокруг = и +, сохранить sum как 10 + 2 и увидеть 12 после java Yard. Скомпилируйте Yard.java и запустите java Yard для сохранённой демо. Раскладка помогла читателям; математика осталась двенадцать. Следующая страница — даты, где вы работаете с календарными значениями в Java.
Держите демо аккуратной суммы для ясной пары раскладка-плюс-запуск. Держите файлы именования вне этой страницы, когда практикуете отступ. Держите файлы dates вне этой страницы до того урока. Эти три привычки — контрольная точка перед переходом. Когда скобки показывают блок, а экран показывает 12, форматирование сделало своё дело для этого урока, и вы готовы к следующей теме о датах.
Ещё один проход по папке: один public Yard, тело main с отступом, операторы с пробелами, без ожидания клавиатуры, без принудительных типов даты. Ещё раз запустите javac Yard.java и java Yard на демо, которую держите открытой. Если экран всё ещё показывает 12, а отступ всё ещё помечает тело, форма форматирования крепка, и курс может перейти к датам на следующей странице. Предпочитайте одну ясную привычку раскладки на чтение, чтобы каждый проход учил тот же чек-лист.