Когда после выгрузки «сбились формулы», сначала откройте файл как архив данных, а не как привычную книгу. CSV вообще не хранит листы, стили и формульную модель книги: это строки значений с разделителями. Если на входе был XLSX, а на выходе CSV, исчезновение формул ожидаемо. Исправлять формулу в этом случае бессмысленно — выбран не тот формат результата.
Вторая частая ситуация выглядит похоже, но причина иная: API прочитал рассчитанное значение, а затем записал его в новую таблицу. На экране число совпадает, пока исходные данные не меняются. После изменения пользователь обнаруживает, что пересчёта больше нет. Найдите одну контрольную ячейку и проследите не только её отображение, но и буквальный текст формулы.
Три результата нельзя называть одной выгрузкой
| Нужный результат | Подходящий формат | Что не сохранится |
|---|---|---|
| обмен строками | CSV или TSV | формулы, несколько листов, стили, проверки |
| готовая книга | XLSX или ODS | зависит от поддержки функций библиотекой |
| живая совместная модель | Google Sheets | часть функций может зависеть от локали и API |
| неизменяемый отчёт | редактирование и пересчёт | |
| машинный набор | JSON или API | оформление и формульный интерфейс |
Microsoft прямо предупреждает: при сохранении книги в текстовый или CSV-формат часть данных и возможностей теряется, а форматирование удаляется. В CSV сохраняются отображаемые текст и значения активного листа. Поэтому безопасная схема часто состоит из двух файлов: CSV как переносимый набор данных и XLSX как отчётный шаблон с формулами.
Контрольная карточка ячейки ловит подмену значения
cell: Report!G18
formula_before: =SUM(G2:G17)
value_before: 148320.50
export_format: xlsx
read_mode: FORMULA
write_mode: USER_ENTERED
locale: ru_RU
formula_after: =SUM(G2:G17)
value_after: 148320.50Для Google Sheets API параметр ValueRenderOption определяет, что вернётся при чтении: FORMATTED_VALUE — рассчитанное и оформленное значение, UNFORMATTED_VALUE — рассчитанное значение без оформления, FORMULA — сама формула. Если задача переносит модель, чтение в режиме FORMATTED_VALUE уже уничтожает нужную информацию на границе API.
При записи ValueInputOption RAW оставляет строки неразобранными, а USER_ENTERED применяет правила интерфейса Sheets: строки могут стать числами, датами или формулами. Выбор должен быть явным. Для пользовательских данных безопаснее RAW, а для доверенного шаблона формул — контролируемый USER_ENTERED. Не смешивайте их в одном неразмеченном массиве.
Локаль меняет не только внешний вид числа
- десятичный разделитель может быть запятой или точкой;
- разделитель аргументов формулы зависит от среды;
- названия функций могут отображаться или импортироваться иначе;
- строка 01.02.2026 способна стать разной датой;
- имя листа с пробелом требует корректного quoting в ссылке;
- внешняя ссылка может не поддерживаться библиотекой генерации XLSX.
Не лечите локаль глобальной заменой запятых и точек: она испортит текстовые поля и часть формул. Храните числовые значения числами, даты — однозначными датами, а целевую локаль задавайте на уровне книги. После генерации открывайте файл тем же движком или совместимой библиотекой и проверяйте формулу и вычисленное значение отдельно.
Шаблон и данные обновляются в разных областях
Устойчивый отчёт содержит лист Data, куда процесс записывает только значения, и лист Report с проверенными формулами, диаграммами и форматами. Обновление очищает заданный диапазон Data, а не пересоздаёт книгу целиком. Формулы ссылаются на таблицу или именованные диапазоны, которые расширяются предсказуемо.
- Сделать версию шаблона и хранить её вместе с отчётом.
- Проверить обязательные листы, заголовки и именованные диапазоны.
- Записать данные только в предназначенный диапазон.
- Открыть контрольные ячейки и сравнить текст формулы с эталоном.
- Проверить вычисленные значения и ошибки #REF!, #NAME? и #VALUE!.
- Сохранить журнал версии шаблона, локали и библиотеки экспорта.
Ошибка диапазона видна на маленьком тесте
Соберите тест из трёх строк: обычное число, пустое значение и строка с запятой. Добавьте сумму, ссылку на другой лист и формулу с датой. Такой файл быстрее покажет, где происходит потеря: при чтении исходника, сериализации, записи, открытии или пересчёте. Большой отчёт только маскирует границу сбоя.
Для диагностики приложите исходный и полученный файл без персональных данных, формат, локаль, одну контрольную формулу, режимы API и версию библиотеки. Не пересылайте рабочую книгу с финансовыми данными, если проблему можно воспроизвести на пяти ячейках. Решение считается готовым, когда повторная выгрузка сохраняет формулу и даёт ожидаемый пересчёт после изменения входной строки.