Вкладки в скетче: раскладываем код по файлам

Скетч автополива я тащил в одном файле до семисот строк: сверху константы, посередине меню дисплея, ниже полив, в самом низу — журнал, который я обещал себе «потом разобрать». Каждая правка начиналась с минуты прокрутки и поиска заветной строки, а Ctrl+F по слову state выдавал четырнадцать совпадений. Вечер, когда я второй раз за неделю сломал рабочую ветку, поправив не тот блок, стал днём, когда я открыл стрелочку справа сверху и узнал про вкладки.

Механика мелкая: в правом верхнем углу окна, за кнопкой с тремя точками, прячется New Tab — имя файла, Enter, и скетч превращается в стопку листов с ярлыками, как папка в ящике стола. Табы мелькали в уроке про горячие клавиши IDE как одна из фишек; здесь разберу то, что за ними стоит: куда файл попадает на диске, что среда делает с папкой при сборке и почему заголовочный файл без include-гарда валит компиляцию на ровном месте.

Плата для темы не нужна: всё, что описано ниже, происходит в папке на компьютере, и то же самое можно делать руками в проводнике. Но вкладки быстрее: не нужно переключать окна, а структура папки скетча остаётся канонической — среда сама раскладывает файлы так, как их ждёт сборщик.

Найти ярлыки можно и в классике, и в IDE 2: полоска вкладок лежит над редактором, справа от имени скетча, и в ней же живут кнопка-стрелочка и выпадающее меню с New Tab, Rename и Delete. С Delete я хожу осторожно: удаление вкладки стирает файл с диска, а не прячет ярлык, и среда хотя бы спросит подтверждение. Показать, куда всё сложилось, умеет команда Sketch → Show Sketch Folder — проводник откроется ровно на этой папке.

New Tab создаёт не «виртуальный лист», а настоящий файл в папке скетча — тот самый, который открывается через Sketch → Show Sketch Folder. Ввели helpers.h — получили файл helpers.h рядом с main.ino; закрыли вкладку — файл никуда не делся, при следующем открытии скетча среда снова покажет его ярлыком. Вкладка и файл — одно и то же, у табов нет собственного хранилища.

Второе правило важнее: сборка берёт из папки всё, что распознаёт, — .ino, .cpp, .h, .c и даже ассемблерные .S. Закрытая вкладка, свёрнутая в один ярлык, участвует в компиляции наравне с открытой: «не видно» не значит «не собиралось». Отсюда привычка хранить в папке только живое — черновик my_old_draft.cpp, лежащий рядом, влезет в сборку и через месяц напомнит о себе сообщением, которое придётся расшифровывать в логе компиляции.

Склеивает ли среда файлы в один текст? Нет: каждый .cpp компилируется своим куском, а связывает их линковщик — но для скетча эффект такой, будто всё в одном файле: функции из helpers.cpp видны в main.ino, стоит подключить заголовок. Разница всплывает в одной точке: автоматическую генерацию прототипов среда делает только для .ino. В .cpp каждый тип и каждая функция объявляются руками — не каприз, а следствие того, что .cpp собирается как обычный файл C++.

Навигация между ярлыками — клики, а с ростом папки — поиск: Ctrl+Shift+F в IDE 2 ищет по всем файлам скетча разом, не только по открытой вкладке, и это спасает, когда забыл, в каком из трёх файлов живёт нужная функция. Классика 1.8 ищет только внутри активного файла, и это одна из тихих причин, по которым на многофайловых проектах я переехал на вторую среду.

Раскладка по канону выглядит так. В helpers.h живут объявления: прототипы функций, константы, структуры — всё то, чем файлы договариваются друг с другом. В helpers.cpp — реализация: тела функций плюс два include, #include "helpers.h" и #include <Arduino.h>; без второго компилятор не узнает pinMode и millis, потому что .cpp в скетче не получает ардуиновские типы бесплатно. В main.ino остаётся логика уровня «что делаем», и подключает он заголовок строкой #include "helpers.h".

Кавычки против угловых скобок — мелочь, на которой спотыкаются: свои заголовки подключают в кавычках, системные и библиотечные — в угловых. Формально gcc ищет и так и так, но кавычки вокруг своего файла честнее показывают, где лежит зависимость. Тот же принцип работает в библиотеках: анатомию папки с library.properties и src разбирали в уроке про шаги создания библиотеки — вкладки скетча устроены проще, но идеи те же.

И про имя без расширения: New Tab в классической среде дописывает к имени без точки .ino, и вкладка становится вторым «главным» файлом с генерацией прототипов; в IDE 2 получится файл вовсе без расширения, который сборка молча пропустит. Обе крайности бесполезны, поэтому правило одно: имя вводим с расширением — helpers.h или helpers.cpp, никаких «helpers вообще».

Пара слов о редких жильцах папки: файлы .c и .S среда тоже берёт в сборку, и живут они по тем же правилам, что .cpp, — свои объявления, свои include. А вот вложенная папка внутри скетча игнорируется: сборщик читает верхний уровень, и «спрятал мусор в подпапку» не сработает — лишнее убирайте совсем, а не на уровень ниже.

Порядок компиляции для скетча почти не важен: каждый .cpp собирается независимо, .ino — последним, с той самой генерацией прототипов, а в конце линковщик склеивает объектники в один бинарник. Проблемы начинаются не в порядке, а в дублировании: одинаковые константы в двух файлах, две функции с одним именем — сборка падает со списком конфликтов. Та же папка собирается и без среды: arduino-cli компилирует её из терминала, я показывал это в уроке про CLI-компиляцию.

Границы одной вкладки — вопрос вкуса, но физический предел существует: файл в несколько тысяч строк читается плохо, а вкладок больше десяти — уже навигационная беда. Мой потолок — пять-шесть вкладок на проект: main, экран, датчики, хранилище настроек, конфиг. Внутри вкладки живёт одна тема, и по имени файла понятно, что искать. Когда кусок стабилен, его путь лежит дальше — в библиотеки в IDE, а не в очередную вкладку.

Про переименование: имя скетча, имя .ino и имя папки связаны жёстко — среда хранит проект в папке с тем же именем, что у главного файла. Save As переименовывает всё разом, а ручное переименование файлов в проводнике рассинхронизирует пару, и среда откроет «не тот» скетч или вовсе пустое окно. Имена вкладок давайте смысловые с первого дня: config.h, sensor.h, menu.h — через полгода список ярлыков читается как оглавление, а file1.cpp и new2.h превращают навигацию в лотерею. Переименовывает вкладку Rename из того же меню со стрелочкой — среда поправит и файл на диске, а include в кавычках придётся править руками, и про него забывают чаще всего.

Мнение, с которым можно спорить: вкладки нужны, только когда скетч возвращается в работу. Скетч на сто пятьдесят строк, написанный за вечер и залитый в плату раз и навсегда, раскладывать по файлам — чистый ритуал: заголовки добавят include, кавычки и гарды, а выгода останется нулевой. Мой порог — двести строк или второй вечер работы: ниже порога хватает одной вкладки, выше — пора резать.

Резать я приучился по правилу «стабильное — вглубь»: то, что больше не правлю — драйвер датчика, отрисовка шрифтов, экранное меню, — уезжает в отдельную вкладку и перестаёт попадаться на глаза. То, что живёт, — планирование, пороги, обработка кнопок — остаётся в main. Через месяц такой разметки скетч читается как оглавление: открыл таб по теме, а не листал весь файл.

Против яда «разложу красиво заранее»: структура, вынесенная до того, как код устоялся, обычно оказывается мимо — файлы переезжают, include переписываются, а времени это съедает больше, чем даёт. Вкладки в скетче — не архитектура, а гигиена: сначала код устаканился, потом разложен. Если скетч так и не устоялся — возможно, ему не нужно ничего, кроме Ctrl+T и честных имён.

Честный чек на своём опыте: последний раз вкладки окупились за один вечер — из шестисот строк поливочного скетча я за полчаса вынес экранное меню и работу с датчиком, и следующая правка порогов заняла две минуты вместо десяти. Окупаемость меряется не красотой, а скоростью следующей правки: если разложить — и ничего не стало быстрее, значит, резали рано.