Переменная в 1С: определение, типы, синтаксис и практические примеры

В мире 1С:Предприятие переменные — это фундаментальный элемент, без которого невозможно представить ни одну программу или обработку. Они служат своеобразными "контейнерами" для хранения данных: чисел, строк, дат, ссылок на объекты и других типов информации. Без переменных разработчик не смог бы писать гибкий код, адаптировать логику под разные условия или сохранять промежуточные результаты вычислений.

Если вы только начинаете осваивать встроенный язык 1С, понятие переменной может показаться абстрактным. Однако на практике всё проще: переменная — это именованная область памяти, куда можно записать значение иlater обратиться к нему по имени. Например, вместо того чтобы каждый раз считать сумму документа заново, вы сохраняете её в переменную ИтоговаяСумма и используете дальше в коде. Это экономит ресурсы системы и делает программы понятнее.

В этой статье мы разберём, что такое переменная в 1С 8.3 и 1С 8.2, какие бывают виды переменных, как их правильно объявлять и где применять. Особое внимание уделим типичным ошибкам новичков и нюансам, которые не всегда очевидны с первого взгляда. Материал будет полезен как начинающим разработчикам, так и опытным специалистам, которые хотят систематизировать знания.

Что такое переменная в 1С простыми словами

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

• 📦 Имя переменной — уникальный идентификатор (например, КоличествоТоваров или ДатаОплаты), по которому к ней обращаются в коде.
• 📊 Тип данных — определяет, что можно хранить в переменной: число, строка, дата, ссылка на справочник и т.д.
• 🔄 Значение — конкретные данные, записанные в переменную на текущий момент (например, число 100 или строка "Привет!").

Главное отличие переменных в 1С от других языков программирования — их динамическая типизация. Это значит, что тип переменной не нужно указывать заранее (как, например, в C# или Java). Система сама определяет тип на основе присваиваемого значения. Например, если вы напишете:

Переменная = 42;

— то 1С автоматически сделает Переменная числового типа. А если позже присвоить ей строку:

Переменная = "Теперь это текст";

— тип изменится на Строка. Такая гибкость удобна, но требует внимательности: неправильное использование типов — одна из самых распространённых ошибок новичков.

Типы переменных в 1С: полный обзор

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

Простые (примитивные) типы

Тип	Описание	Пример значения	Пример объявления
Число	Целые и дробные числа. Поддерживает арифметические операции.	10, 3.14, -1000.5	Количество = 5;
Строка	Текстовая информация. Ограничение по длине зависит от версии платформы.	"Привет", "123" (это строка, а не число!)	Приветствие = "Добро пожаловать!";
Дата	Дата и/или время. Поддерживает операции сложения/вычитания дней.	'2026-12-31', ТекущаяДата()	Сегодня = ТекущаяДата();
Булево	Логическое значение: Истина или Ложь.	Истина, Ложь	ЕстьОшибка = Ложь;
Null	Специальное значение "ничего". Указывает на отсутствие данных.	Неопределено	Результат = Неопределено;

Сложные (составные) типы

Кроме простых типов, в 1С есть переменные, которые хранят более комплексные структуры данных:

• 📚 Массив — упорядоченный набор элементов. Пример: СписокТоваров = Новый Массив;
• 🔗 Структура — набор пар "ключ-значение". Пример: ДанныеКлиента = Новый Структура;
• 📑 ТаблицаЗначений — двумерная таблица с колонками и строками. Пример: Таблица = Новый ТаблицаЗначений;
• 🔄 Ссылка на объект — указатель на элемент справочника, документ, регистр и т.д. Пример: СсылкаНаДокумент = Документы.ЗаказПокупателя.НайтиПоНомеру("0001");

Особенно важно понимать разницу между значением и ссылкой. Например, если вы присваиваете переменной элемент справочника:

Товар = Справочники.Номенклатура.НайтиПоНаименованию("Молоко");

— то в Товар попадёт не сам объект, а ссылка на него. Это позволяет экономить память и работать с объектами базы данных без их копирования.

Как объявить переменную в 1С: синтаксис и правила именования

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

Базовый синтаксис

Минимальный вариант объявления:

ИмяПеременной = Значение;

Примеры:

Сумма = 1000;          // Число
ИмяКлиента = "Иванов";  // Строка
ДатаСоздания = '2026-01-15'; // Дата
Флаг = Истина;          // Булево значение

Если переменная объявлена без начального значения, она автоматически получает значение Неопределено:

ПеременнаяБезЗначения;

Правила именования переменных

Имена переменных в 1С должны соответствовать следующим требованиям:

• ✅ Начинаться с буквы или символа подчёркивания (_).
• ✅ Содержать только буквы, цифры и _.
• ❌ Не содержать пробелов, знаков препинания или специальных символов (@, #, $ и т.д.).
• ❌ Не совпадать с зарезервированными словами языка (например, Если, Тогда, Иначе).

Примеры корректных имён:

КоличествоТоваров
ДатаПоследнегоЗаказа
_ВременнаяПеременная
СуммаНДС_20

Примеры некорректных имён:

2Товара       // Начинается с цифры
Имя Клиента    // Содержит пробел
Сумма$         // Специальный символ
Если           // Зарезервированное слово

Стиль именования: рекомендации

Хотя 1С не накладывает жёстких ограничений на стиль именования, следуйте общепринятым соглашениям, чтобы ваш код был читаемым:

• 📌 Для переменных используйте верблюжью нотацию (CamelCase) или змеиный регистр (snake_case). Пример: КоличествоТоваров или количество_товаров.
• 📌 Начинайте имена со строчной буквы (например, датаДокумента, а не ДатаДокумента).
• 📌 Для временных переменных используйте префикс _ (например, _временныйМассив).
• 📌 Избегайте транслита (например, Kolichestvo — плохо, Количество — хорошо).

Зарезервированные слова в 1С

Полный список:Полный список зарезервированных слов включает конструкции языка (Если, Тогда, Иначе, Для, Пока, Попытка и др.), названия типов (Число, Строка, Дата), стандартные функции (Сообщить, Найти, Выбрать) и другие. Их нельзя использовать в качестве имён переменных. Полный актуальный список можно найти в синтакс-помощнике конфигуратора (клавиша F1).

Область видимости переменных: где и как их использовать

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

1. Локальные переменные

Объявляются внутри процедуры или функции и доступны только в её пределах. После завершения выполнения процедуры локальные переменные уничтожаются.

Процедура РассчитатьСумму()
ЛокальнаяСумма = 100 + 200; // Доступна только здесь
Сообщить(ЛокальнаяСумма);
КонецПроцедуры

Если попытаться обратиться к ЛокальнаяСумма за пределами процедуры, 1С выдаст ошибку.

2. Глобальные переменные

Объявляются на уровне модуля (например, в модуле формы или объекта) и доступны во всех процедурах и функциях этого модуля. Для объявления используется ключевое слово Перем:

Перем ГлобальнаяСумма; // Объявление

Процедура УстановитьСумму()
ГлобальнаяСумма = 500; // Доступна везде в модуле
КонецПроцедуры

⚠️ Внимание: Злоупотребление глобальными переменными может привести к трудноулавливаемым ошибкам, особенно в больших проектах. Используйте их только когда это действительно необходимо (например, для хранения настроек формы).

3. Переменные в выражениях и параметры процедур

Это временные переменные, которые существуют только в момент выполнения выражения или вызова процедуры. Например:

// Параметр процедуры
Процедура ПечатьСчета(НомерСчета)
Сообщить("Номер счёта: " + НомерСчета);
КонецПроцедуры

// Переменная в выражении
Результат = (А + Б) * 2; // А и Б доступны только в этом выражении

Особое внимание уделите параметрам процедур: они передаются по значению (копируются) или по ссылке (изменяют оригинал). Например:

// Передача по значению (изменения внутри процедуры не затронут оригинал)
Процедура УвеличитьЧисло(Число)
Число = Число + 1;
КонецПроцедуры

// Передача по ссылке (изменения затронут оригинал)
Процедура УвеличитьЧислоПоСсылке(Число ПоСсылке)
Число = Число + 1;
КонецПроцедуры

Практические примеры использования переменных в 1С

Теория без практики мало полезна. Давайте рассмотрим несколько реальных примеров, где переменные играют ключевую роль в решении типовых задач.

Пример 1: Расчёт суммы документа

Допустим, нам нужно посчитать итоговую сумму заказа с учётом скидки и НДС:

Процедура РассчитатьИтоговуюСумму(Заказ)
СуммаБезСкидки = Заказ.СуммаДокумента;
Скидка = Заказ.ПроцентСкидки / 100;
СуммаСоСкидкой = СуммаБезСкидки * (1 - Скидка);
НДС = СуммаСоСкидкой * 0.2; // Предполагаем НДС 20%
ИтоговаяСумма = СуммаСоСкидкой + НДС;

Сообщить("Итоговая сумма: " + ИтоговаяСумма);
КонецПроцедуры

Здесь мы используем локальные переменные для хранения промежуточных результатов. Обратите внимание, как имена переменных отражают их назначение: СуммаБезСкидки, ИтоговаяСумма и т.д.

Пример 2: Работа с массивом товаров

Предположим, нам нужно обработать список товаров из документа и найти самый дорогой:

Процедура НайтиСамыйДорогойТовар(СписокТоваров)
МаксимальнаяЦена = 0;
НаименованиеДорогогоТовара = "";

Для Каждый Товар Из СписокТоваров Цикл
Если Товар.Цена > МаксимальнаяЦена Тогда
МаксимальнаяЦена = Товар.Цена;
НаименованиеДорогогоТовара = Товар.Наименование;
КонецЕсли;
КонецЦикла;

Сообщить("Самый дорогой товар: " + НаименованиеДорогогоТовара +
", цена: " + МаксимальнаяЦена);
КонецПроцедуры

В этом примере:

• 📌 МаксимальнаяЦена и НаименованиеДорогогоТовара — переменные для хранения результатов.
• 📌 Товар — временная переменная цикла Для Каждый.

Пример 3: Использование структуры для хранения данных

Структуры удобны, когда нужно сгруппировать связанные данные. Например, информацию о клиенте:

Процедура СобратьДанныеКлиента(Клиент)
ДанныеКлиента = Новый Структура;
ДанныеКлиента.Вставить("Имя", Клиент.Наименование);
ДанныеКлиента.Вставить("Адрес", Клиент.Адрес);
ДанныеКлиента.Вставить("Телефон", Клиент.Телефон);
ДанныеКлиента.Вставить("ДатаРегистрации", Клиент.ДатаРегистрации);

// Теперь можно передать всю структуру в другую процедуру
ОбработатьДанныеКлиента(ДанныеКлиента);
КонецПроцедуры

Важно: Структуры в 1С передаются по ссылке, поэтому изменения в переданной структуре затронут оригинал.

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

Даже опытные разработчики иногда допускают ошибки при работе с переменными. Рассмотрим наиболее распространённые из них и способы их предотвращения.

1. Использование неинициализированных переменных

Если переменная объявлена, но ей не присвоено значение, она содержит Неопределено. Операции с такими переменными часто приводят к ошибкам:

Переменная; // Неопределено
Результат = Переменная + 10; // Ошибка: невозможно сложить Неопределено и число

✅ Решение: Всегда инициализируйте переменные начальными значениями:

Количество = 0; // Для чисел
Имя = "";       // Для строк

2. Путаница с типами данных

Из-за динамической типизации легко допустить ошибку, присвоив переменной значение не того типа. Например:

Сумма = "100"; // Это строка, а не число!
Итог = Сумма + 50; // Результат: "10050" (конкатенация строк), а не 150

✅ Решение: Явно преобразуйте типы при необходимости:

Сумма = Число("100"); // Теперь это число
Итог = Сумма + 50;     // Результат: 150

3. Изменение глобальных переменных в неожиданных местах

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

Перем ОбщаяСумма;

Процедура ДобавитьКСумме(Значение)
ОбщаяСумма = ОбщаяСумма + Значение; // А что, если ОбщаяСумма не инициализирована?
КонецПроцедуры

✅ Решение: Инициализируйте глобальные переменные при объявлении и комментируйте их назначение:

Перем ОбщаяСумма = 0; // Итоговая сумма всех операций

⚠️ Внимание: В многопользовательском режиме глобальные переменные модуля формы или объекта разные для каждого сеанса. Однако глобальные переменные общего модуля с флагом "Глобальный" разделяются между всеми пользователями, что может привести к конфликтам!

4. Неправильное использование параметров по ссылке

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

Процедура ПечатьДанных(Данные ПоСсылке) // Зачем ПоСсылке, если данные не меняются?
Сообщить(Данные);
КонецПроцедуры

✅ Решение: Используйте ПоСсылке только когда действительно нужно изменить оригинальную переменную.

5. "Магические числа" и строки в коде

Использование жёстко заданных значений (например, НДС = 0.2) делает код менее гибким. Если ставка НДС изменится, придётся искать все такие места вручную.

✅ Решение: Выносите такие значения в переменные или константы:

СтавкаНДС = 0.2; // Легко изменить в одном месте
НДС = Сумма * СтавкаНДС;

Переменные в запросах 1С: особенности и примеры

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

Использование параметров в запросах

Параметры позволяют сделать запросы гибкими и безопасными (защита от SQL-инъекций). Пример:

ДатаНачала = '2026-01-01';
ДатаОкончания = '2026-01-31';

Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
|   Документ.Ссылка КАК Ссылка,
|   Документ.Дата КАК Дата,
|   Документ.СуммаДокумента КАК Сумма
|ИЗ
|   Документ.ЗаказПокупателя КАК Документ
|ГДЕ
|   Документ.Дата МЕЖДУ &ДатаНачала И &ДатаОкончания";

Запрос.УстановитьПараметр("ДатаНачала", ДатаНачала);
Запрос.УстановитьПараметр("ДатаОкончания", ДатаОкончания);

РезультатЗапроса = Запрос.Выполнить();

Здесь &ДатаНачала и &ДатаОкончания — параметры запроса, которые заменяются на реальные значения перед выполнением.

Обработка результатов запроса

После выполнения запроса результат обычно сохраняют в переменную типа РезультатЗапроса и затем обрабатывают:

Выборка = РезультатЗапроса.Выбрать();

Пока Выборка.Следующий() Цикл
СсылкаНаДокумент = Выборка.Ссылка;
ДатаДокумента = Выборка.Дата;
СуммаДокумента = Выборка.Сумма;

// Обработка данных
Сообщить("Документ: " + СсылкаНаДокумент + ", Сумма: " + СуммаДокумента);
КонецЦикла;

Обратите внимание, как переменные СсылкаНаДокумент, ДатаДокумента и СуммаДокумента используются для хранения данных из текущей строки выборки.

Динамическое формирование текста запроса

Иногда текст запроса нужно формировать динамически — например, добавлять условия в зависимости от параметров. Для этого удобно использовать переменные:

УсловиеПоДате = "";
Если ДатаНачала <> Неопределено Тогда
УсловиеПоДате = "ГДЕ Документ.Дата >= &ДатаНачала";
КонецЕсли;

ТекстЗапроса =
"ВЫБРАТЬ
|   Документ.СуммаДокумента КАК Сумма
|ИЗ
|   Документ.ЗаказПокупателя КАК Документ" +
УсловиеПоДате;

⚠️ Внимание: При динамическом формировании запросов будьте осторожны с SQL-инъекциями. Всегда используйте параметры (УстановитьПараметр) вместо конкатенации строк с пользовательским вводом.

Отладка и работа с переменными в конфигураторе 1С

Конфигуратор 1С:Предприятие предоставляет мощные инструменты для отладки кода и анализа переменных. Рассмотрим основные приёмы, которые помогут вам быстрее находить и исправлять ошибки.

1. Просмотр значений переменных в отладчике

Чтобы увидеть текущие значения переменных во время выполнения кода:

1. Установите точку останова (клавиша F9 или щелчок слева от строки кода).
2. Запустите отладку (F5 или кнопка "Начать отладку").
3. Когда выполнение остановится на точке, наведите курсор на имя переменной — появится подсказка с её значением.
4. Для детального просмотра используйте окно Локальные переменные (обычно внизу экрана).

Пример: если вы остановились на строке:

Итог = Сумма + НДС;

— вы сможете увидеть текущие значения Сумма, НДС и Итог.

2. Вывод значений с помощью Сообщить()

Простейший способ диагностики — вывод значений в окно сообщений:

Сообщить("Текущая сумма: " + Сумма);
Сообщить("Тип переменной: " + ТипЗнч(Переменная));

Для сложных объектов (массивов, структур) используйте функцию СтрокаСообщить():

Массив = Новый Массив;
Массив.Добавить(1);
Массив.Добавить(2);
Сообщить(СтрокаСообщить(Массив)); // Выведет: [1, 2]

3. Использование точек останова с условием

Если точка останова срабатывает слишком часто, можно добавить условие. Например, остановиться только когда Сумма > 1000:

1. Установите точку останова на нужной строке.
2. Щёлкните правой кнопкой по точке → Условие.
3. Введите условие, например: Сумма > 1000.

4. Анализ стека вызовов

Если ошибка возникла глубоко в цепочке вызовов процедур, используйте окно Стек вызовов (обычно доступно в меню Отладка). Оно покажет последовательность вызовов, которая привела к текущей строке кода.

Пример стека вызовов:

ОбработатьЗаказ()
→ РассчитатьСумму()
→ ПрименитьСкидку()
→ ТекущаяСтрока (где произошла ошибка)

5. Просмотр глобальных переменных

Чтобы увидеть все глобальные переменные текущего модуля:

1. Во время отладки откройте окно Глобальные переменные (меню Отладка → Окна).
2. Там будут отображены все переменные, объявленные с ключевым словом Перем