К статье
Практический материал

Другое · 7 мин

Объявление переменных в 1С: правила и примеры

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

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

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

Ниже рассмотрены основные способы объявления переменных, правила видимости, способы проверки и частые ошибки. Материал поможет избежать проблем при разработке общих модулей, форм и обработок.

Где объявляются переменные в модуле

Объявление на уровне модуля выполняется в начале модуля, до описания процедур и функций. Синтаксис выглядит так: Перем ИмяПеременной;. Можно объявить несколько переменных через запятую: Перем Сумма, Количество, Наименование;. После такого объявления переменная становится доступна всем процедурам этого же модуля.

Если переменная нужна только в одной процедуре, объявление на уровне модуля не обязательно. Достаточно начать использовать имя внутри процедуры, и платформа считает её локальной для этой процедуры. Такой подход уменьшает риск случайного изменения значения из других частей программы.

Область видимости и ключевое слово Перем

Ключевое слово Перем указывает платформе зарезервировать имя в области видимости модуля. Переменная, объявленная так, видна во всех процедурах модуля, но по умолчанию не видна в других модулях. Это важно при работе с общими модулями, где нужно явно управлять доступом к данным.

Для доступа извне используется модификатор Экспорт: Перем Сумма Экспорт;. Тогда другие модули могут обращаться к переменной через имя общего модуля. Если модификатор не указан, переменная остаётся внутренней для модуля, даже если сам модуль общий.

Порядок действий
  1. 1
    Определите, где нужна переменная: в модуле или внутри процедуры
  2. 2
    На уровне модуля напишите Перем Имя; или Перем Имя Экспорт;
  3. 3
    Внутри процедуры присвойте значение без объявления Перем
  4. 4
    Выполните проверку синтаксиса в Конфигураторе

Локальные переменные внутри процедуры

Внутри процедуры переменная объявляется неявно: достаточно написать Имя = Значение;. Платформа рассматривает такое имя как локальное для данной процедуры. После завершения процедуры значение локальной переменной обычно не сохраняется, если только оно не передано дальше через параметры или возвращено как результат.

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

Сравнение вариантов

Перем на уровне модуля

Подходит для данных, нужных внутри одного модуля; ограничение — недоступна извне без Экспорт

Перем Имя Экспорт

Подходит для доступа из других модулей; ограничение — требует осторожности при одновременном изменении

Локальная переменная процедуры

Подходит для временных вычислений; ограничение — не видна за пределами процедуры

Экспортные переменные и общие модули

Общие модули предназначены для хранения общих процедур, функций и переменных. Если переменная объявлена как Перем Имя Экспорт; в общем модуле, к ней можно обращаться из других объектов конфигурации через имя модуля. Это удобно для хранения справочных значений, настроек или промежуточных результатов, нужных в нескольких местах.

Одновременно экспортные переменные требуют осторожности. Если несколько процедур меняют одну экспортную переменную, сложнее отследить, где именно значение изменилось. В таких случаях часто целесообразнее передавать данные через параметры процедур или возвращать их из функций, а не хранить в общих переменных.

Контрольные точки

Как проверить результат

Переменная объявлена через Перем на уровне модуля
Норма

Проверка синтаксиса проходит без ошибок по этому имени

Тревожный признак

Сообщение о неопределённой переменной при проверке

Переменная доступна из другого модуля
Норма

Обращение через имя модуля компилируется

Тревожный признак

Ошибка доступа к переменной извне

Проверка синтаксиса и отладка

После объявления переменных обязательно выполните проверку синтаксиса в Конфигураторе. Платформа покажет ошибки, если имя переменной использовано без объявления там, где объявление требуется, или если есть опечатки в именах. Успешная проверка не гарантирует отсутствия логических ошибок, но исключает очевидные проблемы с именами.

Для отладки можно использовать режим отладки или вывод значений переменных в сообщения пользователю, чтобы убедиться, что переменная содержит ожидаемое значение на нужном этапе. Если переменная оказывается неопределённой, проверьте место объявления и область видимости: возможно, переменная объявлена в другом модуле без Экспорт.

Типичные ошибки
01
Использование переменной без объявления на уровне модуля приводит к ошибке синтаксиса
02
Совпадение имени локальной и модульной переменной вызывает непонятные изменения значений
03
Изменение экспортной переменной без учёта всех мест её использования ломает логику в других модулях

Типичные ошибки и ограничения

Частая ошибка — использование переменной внутри процедуры без понимания, является ли она локальной или модульной. Если имя совпадает с модульной переменной, внутри процедуры может создаваться отдельная локальная переменная, и изменения не отразятся на модульной. Это приводит к трудноотлавливаемым ошибкам в расчётах.

Ещё одна ошибка — объявление переменной с таким же именем, что и у встроенной функции или свойства объекта. Тогда платформа может интерпретировать имя не так, как ожидает разработчик. Также не стоит объявлять слишком много переменных на уровне модуля: это усложняет поддержку и увеличивает вероятность непреднамеренного изменения данных.

Итог

Что важно запомнить

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

Нужно ли объявлять каждую переменную через Перем?

Нет. Перем обязателен в основном для переменных на уровне модуля. Внутри процедуры переменная может появиться при первом присваивании и считается локальной для этой процедуры.

Как сделать переменную доступной из других модулей?

Объявите её в общем модуле с модификатором Экспорт: Перем Имя Экспорт;. Тогда другие объекты конфигурации смогут обращаться к ней через имя этого модуля.

Что делать, если проверка синтаксиса ругается на переменную?

Проверьте, объявлена ли переменная через Перем в нужном месте, нет ли опечатки в имени и не используется ли она из модуля, где она не экспортирована. Исправьте объявление или имя и запустите проверку снова.

Может ли локальная переменная перекрыть модульную?

Да, если внутри процедуры использовать имя, совпадающее с именем модульной переменной, платформа может работать с локальной переменной, а модульная останется без изменений. Чтобы этого избежать, называйте переменные осознанно и проверяйте область видимости.