git error: Your local changes to the following files would be overwritten by merge: В чем смысл ошибки

error: Your local changes to the following files would be overwritten by merge:
.....
Please, commit your changes or stash them before you can merge.

Общий случай

Все просто - у вас незакомиченные изменения, а вы пытаетесь подтянуть новое состояние из удаленного репозитория, есть как минимум два вариант решения:

  1. или сделать коммит на этой машине (где наблюдается ошибка)
  2. или откатить изменения, если они вам не нужны

Если ошибка на сервере

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

  1. выяснить что изменилось
  2. если эти изменения нужные - скопировать их, если нет, то пропускаем этот пункт
  3. откатить изменения на сервере
  4. если изменения были нужны - применяем их на локальной машине и отправляем в репозиторий обычным образом (внесите изменения в файлы, закоммитьте и выполните пуш).

Главная идея для сервера: на сервере файлы под контролем гит-а править не следует, это будет приводить к ошибкам вроде той, о которой сейчас говорим.

Key Words for FKN + antitotal forum (CS VSU):