Администрирование · 10 мин
1cv8ftxt в 1С: что это за файлы и как с ними работать
Разбираемся, что такое файлы 1cv8ftxt в 1С, зачем нужна выгрузка конфигурации в текстовые файлы, как открыть, изменить и загрузить их обратно без потери данных.
При выгрузке конфигурации 1С:Предприятия 8 в файлы вместо привычного одного файла .cf на диске появляется целое дерево каталогов с множеством текстовых файлов. В этой структуре встречаются и файлы, связанные с форматом 1cv8ftxt — текстовым представлением объектов конфигурации. Такие файлы не предназначены для ручного открытия «как документ», но именно они позволяют хранить конфигурацию в системах контроля версий, сравнивать изменения и автоматизировать сборку.
Формат текстовой выгрузки используется конфигуратором, платформенными утилитами и средой разработки 1C:Enterprise Development Tools (EDT). Понимание того, что лежит внутри этих файлов, помогает безопасно переносить доработки между базами, искать, где именно изменился модуль, и восстанавливать отдельные объекты без полной загрузки конфигурации.
Материал ориентирован на администраторов и разработчиков 1С, которые столкнулись с каталогом текстовых файлов вместо привычного .cf и хотят понять, что с ним делать: открыть, изменить, сравнить или загрузить обратно в информационную базу.
Что такое 1cv8ftxt и откуда берутся эти файлы
Конфигурация 1С внутри информационной базы хранится в бинарном виде. Для обмена и анализа платформа умеет представлять её в виде набора текстовых файлов: каждый объект метаданных (справочник, документ, отчёт, модуль, форма) выгружается в отдельный файл или набор файлов. Текстовое представление, с которым работает платформа при такой выгрузке, и называют форматом 1cv8ftxt.
На практике вы чаще увидите не отдельный файл с таким расширением, а каталог выгрузки: в нём лежит корневой файл Configuration с описанием структуры, подкаталоги Catalogs, Documents, CommonModules и десятки файлов с модулями на встроенном языке. Вся эта совокупность — один логический формат, который платформа умеет собирать обратно в конфигурацию.
Получить такую выгрузку можно тремя способами: через конфигуратор (Конфигурация → Выгрузить конфигурацию в файлы), через пакетный режим конфигуратора с параметрами командной строки, а также при работе проекта в EDT, который хранит конфигурацию именно в файловом виде.
Чем текстовая выгрузка отличается от файла .cf
Файл .cf — это монолитный бинарный контейнер. Его удобно передавать целиком, но невозможно посмотреть внутрь без конфигуратора и нельзя нормально хранить в Git: любое изменение превращает файл в новый бинарный объект, и сравнение версий бессмысленно.
Текстовая выгрузка решает обе проблемы. Каждый модуль хранится как обычный текстовый файл, который читается любым редактором и корректно сравнивается инструментами diff. Изменение одной процедуры видно как изменение нескольких строк, а не как «файл изменился полностью».
| Критерий | Файл .cf | Текстовая выгрузка (1cv8ftxt) |
|---|---|---|
| Структура | Один бинарный файл | Дерево текстовых файлов и каталогов |
| Просмотр без платформы | Невозможен | Любой текстовый редактор |
| Контроль версий (Git) | Неэффективен | Полноценный diff и история изменений |
| Частичная загрузка | Только через сравнение/объединение | Можно загружать отдельные объекты |
| Передача поставщику | Удобно | Требует предварительной сборки в .cf |
Как выгрузить конфигурацию в текстовые файлы
Самый простой путь — через конфигуратор. Откройте нужную базу, выберите в меню «Конфигурация» пункт «Выгрузить конфигурацию в файлы» и укажите пустой каталог. Платформа создаст в нём полную структуру конфигурации. Учтите: выгружать можно как всю конфигурацию, так и выбранные объекты — это задаётся в диалоге выгрузки.
Для автоматизации удобнее пакетный режим. Конфигуратор запускается с параметрами, выполняет выгрузку и завершает работу без участия пользователя — так строят ночные выгрузки в репозиторий.
"C:\Program Files\1cv8\<версия>\bin\1cv8.exe" DESIGNER /F"C:\Bases\MyBase" /N"Администратор" /P"пароль" /DumpConfigToFiles "D:\Repo\MyConfig" /DumpConfigToFilesFormat OrdinaryПри выгрузке через командную строку проверяйте код возврата и лог: если конфигуратор не смог подключиться к базе или не хватило прав, каталог останется пустым или неполным, а ошибка будет видна только в журнале запуска.
- 1Сделайте резервную копию базы или убедитесь, что работаете с копией
- 2Откройте конфигуратор и разблокируйте конфигурацию от изменений, если она на поддержке
- 3Выберите Конфигурация → Выгрузить конфигурацию в файлы
- 4Укажите пустой каталог и при необходимости отметьте только нужные объекты
- 5Дождитесь завершения и проверьте наличие корневого файла Configuration в каталоге
Как загрузить файлы обратно в конфигурацию
Обратная операция выполняется через пункт «Загрузить конфигурацию из файлов». Платформа читает каталог, собирает объекты и обновляет конфигурацию базы данных после подтверждения. В пакетном режиме используется параметр LoadConfigFromFiles с указанием того же каталога.
Загрузка возможна и частичная: можно загрузить только изменённые объекты, если выгрузка и загрузка выполняются согласованно. Это удобно при переносе доработок между контурами разработки и тестирования, но требует дисциплины — пропущенный зависимый объект приведёт к ошибкам при обновлении.
Можно ли редактировать файлы вручную
Технически модули в текстовой выгрузке открываются и правятся любым редактором, и иногда этим пользуются: массовая замена по всем модулям, быстрый поиск вызовов, правка одной строки без запуска конфигуратора. После правки каталог загружается обратно, и изменения попадают в конфигурацию.
Однако ручная правка имеет жёсткие ограничения. Нельзя переименовывать и удалять файлы объектов, не понимая связей: ссылки между объектами описаны в служебных файлах, и нарушение структуры сделает загрузку невозможной. Нельзя менять служебные заголовки и идентификаторы. Безопасная зона ручной правки — это, по сути, только текст программных модулей, и даже его после загрузки нужно проверять синтаксическим контролем в конфигураторе.
Зачем формат нужен в реальной работе
Главный сценарий — командная разработка с контролем версий. Текстовая выгрузка кладётся в Git, и команда получает историю изменений по каждому модулю, код-ревью через merge request и возможность откатить конкретную правку. Именно на этом формате строится работа с EDT и большинство практик CI/CD в экосистеме 1С.
Второй сценарий — диагностика и сравнение. Когда нужно понять, чем две версии конфигурации отличаются на уровне кода, сравнение двух каталогов текстовой выгрузки любым diff-инструментом даёт точный ответ быстрее, чем штатное сравнение конфигураций.
Третий сценарий — автоматизация: скрипты сборки выгружают конфигурацию из хранилища или базы в файлы, прогоняют проверки и собирают обратно .cf для поставки. Без текстового представления такой конвейер был бы невозможен.
Как выбрать действие
Проверка результата и ограничения формата
После любой загрузки из файлов выполните контроль: запустите проверку конфигурации (Конфигурация → Проверка конфигурации) с синтаксическим контролем модулей, убедитесь, что база открывается в режиме предприятия, и пройдите ключевой пользовательский сценарий. Если обновление конфигурации базы данных требовало реструктуризации, дополнительно проверьте данные затронутых таблиц.
У формата есть ограничения. Он привязан к версии платформы: выгрузка, созданная одной версией, не всегда корректно загружается значительно более старой. Структура файлов — внутренний формат вендора, и её детали могут меняться между релизами. Наконец, текстовая выгрузка не заменяет выгрузку данных: это только конфигурация, без пользовательских данных информационной базы.
Как проверить результат
Файл присутствует, каталог содержит подкаталоги объектов
Каталог пуст или неполный — выгрузка завершилась с ошибкой
Загрузка и обновление проходят без ошибок, база открывается
Ошибки формата или реструктуризации — файлы повреждены или несовместимы
Синтаксический контроль модулей без ошибок
Ошибки в модулях — вероятна некорректная ручная правка
Что важно запомнить
1cv8ftxt — текстовое представление конфигурации 1С при выгрузке в файлы. Его создают и читают конфигуратор, EDT и пакетный режим. Формат незаменим для контроля версий и автоматизации, но любую загрузку из файлов выполняйте только после резервного копирования и с проверкой на копии базы.
Частые вопросы
Чем открыть файлы текстовой выгрузки 1С?
Модули и описания объектов открываются любым текстовым редактором — Notepad++, VS Code и подобными. Но правильный способ «открыть» выгрузку целиком — загрузить её через конфигуратор или импортировать как проект в EDT, где структура отображается в привычном виде дерева метаданных.
Можно ли удалить каталог выгрузки после загрузки?
Да, после успешной загрузки и проверки конфигурации каталог на диске больше не нужен базе — это внешнее представление. Но если каталог хранится в системе контроля версий, удалять его не следует: это ваша история изменений.
Чем выгрузка в файлы отличается от выгрузки информационной базы в .dt?
Выгрузка в файлы содержит только конфигурацию — метаданные и код. Файл .dt содержит всю базу целиком: конфигурацию и все пользовательские данные. Для резервного копирования данных используется .dt, для разработки и контроля версий — текстовая выгрузка.
Почему загрузка из файлов завершается ошибкой формата?
Чаще всего причины — ручная правка служебных файлов, смешение файлов из разных выгрузок, непустой каталог при выгрузке или несовместимость версий платформы. Проверьте целостность структуры и попробуйте заново выгрузить конфигурацию в чистый каталог той же версией платформы.
Подходит ли текстовая выгрузка для хранения в Git?
Да, это основное назначение формата. Каждый модуль — отдельный текстовый файл, поэтому Git корректно отслеживает изменения построчно. Дополнительно стоит настроить .gitignore для служебных временных файлов и договориться в команде о единой версии платформы для выгрузки.