Настройка Git для совместной работы

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

Эти настройки вы можете выполнить в параметрах 1C:EDT или из командной строки в консоли Git, если Git уже установлен у вас на компьютере.

Чтобы открыть параметры конфигурации Git, нажмите Окно > Параметры... > Совместная работа > Git > Конфигурация.

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

Те же самые действия выполняются из командной строки следующей командой:

git config --global user.email johndoe@example.com

Результат будет один и тот же.

Далее все настройки будут описаны для работы с параметрами 1C:EDT и в качестве справки будут даны консольные команды.

Имя и адрес электронной почты

При первом коммите 1C:EDT попросит вас указать имя и адрес электронной почты, которыми она будет идентифицировать ваши коммиты. Чтобы другие разработчики могли понимать, кто именно внес те или иные изменения.

Если вы пропустили этот шаг или хотите изменить эти параметры, добавьте следующие параметры на вкладке Настройки пользователя:
  • user.name — ваше имя;
  • user.email — ваш адрес электронной почты.

При работе из командной строки используйте следующие команды:

git config --global user.name "John Doe"
git config --global user.email johndoe@example.com

Длинные имена файлов

На вашем компьютере может существовать ограничение на длину имени файла, например 260 символов в операционной системе Windows. Поэтому при клонировании репозиториев или при создании локальных репозиториев вы можете получить ошибку Filename too long.

Чтобы избежать этого, воспользуйтесь следующими советами:
  • располагайте локальные репозитории как можно ближе к корню диска;
  • запустите 1C:EDT от имена администратора и добавьте следующий параметр на вкладке Настройки пользователя:
    • core.longpathstrue.
При работе из командной строки используйте следующую команду (консоль Git должна быть запущена от имени администратора):
git config --system core.longpaths true

Большие файлы

При работе с удаленным репозиторием могут возникать проблемы во время выполнения команд Push to origin и Получить и слить в том случае, когда вы работаете по протоколу HTTP и в репозитории есть большие файлы. В этом случае вам поможет увеличение параметра http.postBuffer.

Например, добавьте следующий параметр на вкладке Настройки пользователя:
  • http.postBuffer1048576000.

При работе из командной строки используйте следующую команду:

git config --global http.postBuffer 1048576000

Подробнее о назначении этого параметра вы можете прочитать в документации Git на английском языке: git config http.postBuffer.

Символы окончания строк

Если разработчики, работающие над проектом, используют разные операционные системы (Microsoft Windows, Linux, macOS), нужно настроить конвертацию символов окончания строк при помещении в репозиторий и чтении из него. Следующие команды настраивают Git таким образом, что в рабочей копии разработчика будут использоваться "родные" для его операционной системы символы, а в репозитории всегда будет использоваться LF.

Для операционной системы Microsoft Windows добавьте следующие параметры на вкладке Настройки пользователя:
  • core.autocrlftrue;
  • core.safecrlftrue.

При работе из командной строки используйте следующие команды:

git config --global core.autocrlf true
git config --global core.safecrlf true
Для операционных систем Linux и macOS добавьте следующие параметры на вкладке Настройки пользователя:
  • core.autocrlfinput;
  • core.safecrlftrue.

При работе из командной строки используйте следующие команды:

git config --global core.autocrlf input
git config --global core.safecrlf true

Подробнее о назначении этих параметров вы можете прочитать в документации Git на английском языке: git config core.autocrlf и git config core.safecrlf.

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

Русские буквы в путях

Файлы с русскими буквами могут показываться в нечитаемой кодировке. Для устранения этой проблемы добавьте следующий параметр на вкладке Настройки пользователя:
  • core.quotePathfalse.

При работе из командной строки используйте следующую команду:

git config --global core.quotePath false

Подробнее о назначении этого параметра вы можете прочитать в документации Git на английском языке: git config core.quotePath.