Как правильно писать кавычки в 1С: инструкция для программистов и пользователей

Работа с кавычками в 1С:Предприятие — одна из тех мелочей, которые могут отнять часы на поиск ошибок. Одни и те же символы ведут себя по-разному в коде, запросах, текстах документов и отчётах. Где-то требуются прямые кавычки (" "), где-то — ёлочки (« »), а в некоторых случаях система вообще игнорирует их или подставляет автоматически. Ошибка в выборе кавычек приводит к синтаксическим ошибкам, проблемам с отображением текста или даже сбоям при обмене данными.

Эта статья покрывает все сценарии использования кавычек в 1С 8.3 и 1С 8.2: от написания кода на встроенном языке до оформления печатных форм. Мы разберём не только технические нюансы, но и типографские правила, которые часто упускают даже опытные разработчики. Например, знали ли вы, что в Запросах кавычки внутри строки нужно экранировать иначе, чем в обычном коде? Или что при экспорте в Excel кавычки могут испортить данные, если не учесть настройки региона?

Если вы программист — здесь найдёте чек-лист для отладки кода. Если пользователь — научитесь правильно оформлять документы, чтобы они корректно печатались и экспортировались. А если вы занимаетесь интеграцией, узнаете, как кавычки влияют на обмен данными в форматах JSON, XML и CSV.

1. Кавычки в коде 1С: синтаксис и правила

В коде 1С:Предприятие кавычки используются для обозначения строковых литералов. Здесь действуют жёсткие правила синтаксиса, нарушение которых приводит к ошибкам компиляции. Основные виды кавычек в коде:

• 🔹 Прямые двойные кавычки (" ") — стандарт для строк в выражениях. Пример: Сообщить("Привет, мир!");
• 🔹 Одинарные кавычки (' ') — используются для обозначения дат и символьных констант. Пример: '2026-12-31' или 'С' (символ "С").
• 🔹 Экранирование — если внутри строки нужна кавычка, её дублируют. Пример: Сообщить("Ошибка: ""неверный формат"""); выведет Ошибка: "неверный формат".

Также нельзя смешивать типы кавычек в одной строке, например: "текст' — это вызовет исключение.

Особый случай — многострочные строки. В 1С их можно создавать с помощью символа | (вертикальная черта) или конкатенации строк (+). Пример:

Запрос = "ВЫБРАТЬ
|  Номенклатура.Наименование КАК Наименование
|ИЗ
|  Справочник.Номенклатура КАК Номенклатура";

⚠️ Внимание: В Запросах (язык 1С:Запрос) кавычки внутри строк экранируются одинарными кавычками, а не дублированием. Например: ГДЕ Наименование = 'ООО "Ромашка"'. Это отличается от правил основного языка!

2. Кавычки в запросах 1С: нюансы и ошибки

Язык запросов 1С имеет собственные правила работы со строками, которые часто становятся источником ошибок. Здесь кавычки используются для:

• 📌 Обозначения строковых значений в условиях (ГДЕ Наименование = "Товар").
• 📌 Экранирования специальных символов (включая сами кавычки).
• 📌 Форматирования результатов (например, в ВЫРАЗИТЬ).

Главное отличие от основного языка: в запросах нельзя использовать одинарные кавычки для строк (они резервированы для дат). Например, такой запрос вызовет ошибку:

// НЕПРАВИЛЬНО!
ВЫБРАТЬ
Наименование КАК Поле
ИЗ
Справочник.Номенклатура
ГДЕ
Наименование = 'Товар'

Правильный вариант:

// ПРАВИЛЬНО
ВЫБРАТЬ
Наименование КАК Поле
ИЗ
Справочник.Номенклатура
ГДЕ
Наименование = "Товар"

Если строка содержит кавычку, её экранируют удвоением:

ВЫБРАТЬ
Наименование КАК Поле
ИЗ
Справочник.Номенклатура
ГДЕ
Наименование = "ООО ""Альфа"""

3. Кавычки в текстах документов и печатных формах

В печатных формах, шаблонах документов и текстах (например, в Договорах или Счётах) кавычки выполняют типографскую функцию. Здесь действуют другие правила:

• 📄 Ёлочки (« ») — стандарт для русскоязычных текстов (ГОСТ Р 7.0.3-2006). Пример: «Товар».
• 📄 Прямые кавычки (" ") — допустимы в технических документах или если ёлочки недоступны.
• 📄 Апострофы (` `) — не используются в русском языке, но могут встретиться в англоязычных шаблонах.

В 1С текстовые поля часто заполняются автоматически из справочников или регистров. Если в исходных данных используются прямые кавычки, а в печатной форме нужны ёлочки, потребуется замена через код. Пример:

ТекстДоговора = СтрЗаменить(ТекстДоговора, """", "«");
ТекстДоговора = СтрЗаменить(ТекстДоговора, """", "»");

Обратите внимание: в коде мы экранируем кавычки дублированием (""""), а в результате получаем ёлочки. Этот приём часто используется при генерации документов для печати.

⚠️ Внимание: При экспорте текста с ёлочками в Excel или CSV они могут отображаться как кракозябры, если файл открывается в программе с неправильной кодировкой (например, ANSI вместо UTF-8). Всегда проверяйте результат экспорта!

Выборка = Справочники.Договора.Выбрать();
Пока Выборка.Следующий() Цикл
Текст = Выборка.ТекстДоговора;
Текст = СтрЗаменить(Текст, """", "«");
Текст = СтрЗаменить(Текст, """", "»");
Выборка.Записать();
КонецЦикла;

4. Кавычки в обмене данными (JSON, XML, CSV)

При интеграции 1С с внешними системами кавычки становятся критически важны. Разные форматы данных требуют разного оформления:

• 📥 JSON — использует только прямые двойные кавычки (" "). Ёлочки или одинарные кавычки приведут к ошибке парсинга. Пример:

  {
  "Контрагент": "ООО \"Ромашка\"",
  "Дата": "2026-12-31"
  }

• 📤 XML — поддерживает любые кавычки, но рекомендуется использовать " " для атрибутов и ' ' внутри значений. Пример:

  <Договор Контрагент="ООО "Ромашка"">
  <Текст>Поставка 'товаров'</Текст>
  </Договор>

• 📑 CSV — если поле содержит кавычку, его оборачивают в кавычки и экранируют дублированием. Пример:

  "Наименование","Описание"
  "Товар 1","Описание с ""кавычками"""

В 1С для работы с JSON часто используется объект ЧтениеJSON/ЗаписьJSON. Он автоматически экранирует кавычки, но если вы формируете JSON-строку вручную, следите за синтаксисом. Например, такой код сгенерирует невалидный JSON:

// НЕПРАВИЛЬНО!
ТекстJSON = '{"Контрагент": "ООО "Ромашка""}'; // Ошибка: неэкранированные кавычки

Правильный вариант:

// ПРАВИЛЬНО
ТекстJSON = "{""Контрагент"": ""ООО \""Ромашка\""""}";

Используются ли прямые двойные кавычки в JSON?|Экранированы ли кавычки внутри строк?|Соответствует ли кодировка файла (UTF-8 для JSON/XML)?|Проверены ли данные на наличие "умных" кавычек?-->

5. Типичные ошибки с кавычками и как их избежать

Ошибки с кавычками в 1С делятся на две категории: синтаксические (код не компилируется) и логические (код работает, но результат неверен). Рассмотрим самые распространённые:

• 🐞 Смешивание типов кавычек в одной строке. Пример ошибки: Сообщить('Ошибка: "файл не найден"'); — здесь одинарная и двойная кавычки конфликтуют.
• 🐞 Неэкранированные кавычки внутри строк. Пример: Запрос.Текст = "ВЫБРАТЬ Наименование КАК "Поле""; — лишняя кавычка разрывает строку.
• 🐞 Ёлочки в коде. Пример: Сообщить(«Привет»); — такой код не скомпилируется.
• 🐞 Копипаст из Word/Excel. Вставленные из внешних источников кавычки часто бывают «умными» (“ ”), которые 1С не распознаёт.

Чтобы избежать ошибок, используйте чек-лист проверки:

1. Проверьте, что все строковые литералы обернуты в " " (не в ‘ ’ или « »).
2. Убедитесь, что кавычки внутри строк экранированы (удвоены).
3. Для запросов помните: даты — в ' ', строки — в " ".
4. При копировании кода из внешних источников заменяйте «умные» кавычки на прямые.

Если ошибка уже возникла, ищите её по сообщению компилятора. Например, ошибка Ожидается: " или символ конца строки почти всегда указывает на проблему с кавычками.

6. Как автоматизировать работу с кавычками

Ручная правка кавычек отнимает время, особенно в больших проектах. К счастью, в 1С есть инструменты для автоматизации:

• 🤖 Регулярные выражения — позволяют массово заменять кавычки в текстах. Пример:

  Текст = СтрЗаменитьПоШаблону(Текст, """", "«");
  Текст = СтрЗаменитьПоШаблону(Текст, """", "»");

• 🤖 Обработки для чистки кода — можно написать универсальную обработку, которая пройдётся по всем модулям и заменит некорректные кавычки.
• 🤖 Настройки типографских правил — в некоторых конфигурациях (например, 1С:Документооборот) есть встроенные инструменты для автоматической расстановки ёлочек.

Для разработчиков полезно создать шаблонные функции для работы с кавычками. Например:

Функция ЭкранироватьКавычкиДляJSON(Значение)
Возврат СтрЗаменить(Значение, """", "\""");
КонецФункции

Функция ЗаменитьНаЕлочки(Значение)
Возврат СтрЗаменить(СтрЗаменить(Значение, """", "«"), """", "»");
КонецФункции

Эти функции можно хранить в общем модуле и вызывать при формировании документов или обмене данными.

⚠️ Внимание: При автоматизированной замене кавычек в больших базах данных обязательно делайте резервную копию. Неправильный шаблон замены может испортить данные, например, превратив 1" монитор в 1« монитор.

7. Кавычки в разных версиях 1С: 8.2 vs 8.3

Правила работы с кавычками в 1С:Предприятие 8.2 и 8.3 в целом совпадают, но есть нюансы:

В 1С 8.3 появились обратные кавычки (``), которые используются для обозначения именованных параметров в строках. Например:

Запрос = "ВЫБРАТЬ
|  ``Номенклатура.Наименование`` КАК ``Наименование``
|ИЗ
|  ``Справочник.Номенклатура`` КАК ``Номенклатура``";

Это упрощает чтение сложных запросов, но не влияет на правила экранирования.

FAQ: Частые вопросы о кавычках в 1С

Сообщить("Ошибка: ""файл не найден""");

Текст = СтрЗаменить(Текст, "“", """");
Текст = СтрЗаменить(Текст, "”", """");

ГДЕ Наименование = "ООО ""Альфа"""

Текст = СтрЗаменить(Текст, """", "«");
Текст = СтрЗаменить(Текст, """", "»");