Листы книги: NewSheet, навигация и удаление

newsheet excelize-вызов выглядит так: f.NewSheet("Отчёт") — и в актуальных версиях v2 возвращает пару значений: индекс нового листа и ошибку. Индекс — это позиция листа в книге, нумерация начинается с единицы: свежая книга имеет Sheet1 с индексом 1, и первый же NewSheet получит индекс 2. Ошибка возвращается, когда имя невалидно — пустая строка, запрещённые символы или дубликат существующего листа; в старых туториалах сигнатура без ошибки, поэтому код из статей пятилетней давности не скомпилируется — та же история, что с путями импорта, только здесь меняется число возвращаемых значений. Порядок вкладок в файле соответствует порядку создания: кто первым сделал NewSheet, тот раньше в списке. Переставлять вкладки руками excelize не даёт — если порядок важен, создавайте листы в нужной последовательности или переименовывайте существующие, а не плодите новые. И запомните: NewSheet не делает лист активным — открытие файла покажет ту вкладку, которую вы назначили активной отдельно, о чём дальше.

Активный лист — это вкладка, которую Excel покажет при открытии файла, и управляется он парой методов: f.SetActiveSheet(index) назначает, f.GetActiveSheetIndex() возвращает текущий индекс. Логика для отчётов простая и почти всегда одна: открываем то, ради чего файл генерировался. Сводка для директора — активной становится вкладка со сводкой, а не технический первый лист, на котором по инерции лежали данные для расчётов. Активный лист — не вопрос вкуса, а вопрос обслуживания: файл, который открывается на правильной вкладке, экономит каждому читателю пару кликов и вопрос в чат «а где смотреть». Практический нюанс: SetActiveSheet принимает именно индекс — то самое число из NewSheet, поэтому в реальном коде возвращаемое значение сохраняют в переменную и передают дальше. Если лист с индексом отсутствует, метод молча ничего не изменит: ошибки не будет, но и эффекта тоже — ещё одна причина хранить индексы осознанно, а не пересчитывать на пальцах. И раз уж называли листы русскими словами — так и оставляйте: имена вкладок кодируются в XML в UTF-8, и Отчёт откроется так же корректно, как Report.

Навигация по книге строится на двух чтениях. f.GetSheetName(index) возвращает имя листа по индексу: единица — первый лист книги, и для невалидного индекса метод вернёт пустую строку, не паникуя. Обратное преобразование тоже нужно, но здесь аккуратнее: метод GetSheetIndex существует, однако его поведение на отсутствующих именах менялось между версиями, поэтому в новом коде я предпочитаю явный проход по f.GetSheetMap() — карте индекс-имя, по которой видно всю книгу целиком. Итерируясь по GetSheetMap, вы за один вызов получаете и количество листов, и их названия с индексами — этого хватает и для проверки, что файл сгенерировался с правильной структурой, и для поиска листа с нужным именем перед чтением данных. Такие проходы удобно оставлять в тестах генерации: структура файла — тоже контракт, и она должна проверяться, а не доверяться памяти. Запомните асимметрию: имя по индексу — тривиально, индекс по имени — с оговорками по версиям, поэтому архитектура кода, которая держит индексы из NewSheet в переменных, надёжнее архитектуры, которая ищет их обратно по строкам в рантайме.

Excel накладывает ограничения на имена листов, и excelize транслирует их в ошибки NewSheet и RenameSheet: имя короче 32 символов, то есть максимум 31; запрещены двоеточие, обратный и обычный слэш, вопросительный знак, звёздочка и квадратные скобки; нельзя пустое имя и нельзя History — резервное имя для журнала изменений общих книг. Звучит как список для зубрёжки, но всплывает ровно в двух местах: когда вы генерируете вкладки с датами вроде 2024/06 — слэш сломает создание, и когда названия приходят из пользовательских данных, где звёздочка встречается свободно. Санитизируйте имена одним местом в коде: функция, заменяющая запрещённые символы на дефис и обрезающая до 31 символа, стоит пять строк и экономит вечер отладки. Порядок вкладок при этом — порядок создания, и переименование его не меняет: Сводка останется на своей позиции, как ни назови. Поэтому последовательность NewSheet-вызовов — это и есть дизайн файла, и относиться к ней стоит как к части контракта отчёта.