Вопрос или проблема
git поставляется с .git/hooks/pre-commit.sample.
Я использовал следующие команды:
cp .git/hooks/pre-commit.sample .git/hooks/pre-commit
sed -i'' 's/diff-index --check/\0 --ignore-blank-lines/g' ".git/hooks/pre-commit"
echo '#/bin/sh
' > w
git add w
git commit
и последняя команда выдала следующий вывод:
w:2: новая пустая строка в конце файла.
Рекомендуется завершать файлы символом новой строки \n или аналогичным. Как это разрешить?
Google поиск не дал результатов. Это проблема только с версией Termux git? У меня нет других систем для тестирования.
git config core.whitespace -blank-at-eof является решением (устраняет ошибку blank line at EOF из git diff-index --check) для этого.
https://git-scm.com/book/en/v2/Customizing-Git-Git-Configuration#_core_whitespace документирует все возможные значения core.whitespace.
(Но все еще не знаю, что вызвало такую настройку по умолчанию.)
Если вы прочтете документацию для git diff-index --check, используемого в хуке, там сказано:
Предупреждает, если изменения вводят маркеры конфликтов или ошибки в пробелах. Какие ошибки в пробелах считаются, контролируется конфигурацией
core.whitespace. По умолчанию, ошибки в пробелах включают конечные пробелы (включая строки, состоящие только из пробелов) и пробелы, которые идут непосредственно перед символом табуляции в начале строки. Завершается с ненулевым статусом если обнаружены проблемы. Несовместим с--exit-code.
Таким образом, опция просто проверяет ошибки в пробелах, определенные в настройке core.whitespace git, как глобально, так и для отдельного репозитория. И там упоминается:
Git настроен по умолчанию для обнаружения и исправления некоторых проблем с пробелами. Он может проверять на наличие шести основных проблем с пробелами — три из них включены по умолчанию и могут быть отключены, а три отключены по умолчанию, но могут быть активированы.
Три, которые включены по умолчанию, это
blank-at-eol, который ищет пробелы в конце строки;blank-at-eof, который замечает пустые строки в конце файла; иspace-before-tab, который ищет пробелы перед табуляцией в начале строки.
Таким образом, проверка на пустые строки с этой опцией и все, что использует настройку, включена по умолчанию. Чтобы отключить это глобально, вы можете просто выполнить:
git config --global core.whitespace -blank-at-eof
где - означает отключение одной из возможностей:
Вы можете указать Git, какие из них вы хотите включить, установив
core.whitespaceв значения, которые вы хотите включить или отключить, разделенные запятыми. Вы можете отключить опцию, добавив-перед ее названием, или оставить значение по умолчанию, просто не упоминая его в строке настройки.
Ответ или решение
Введение
Когда вы используете команду git diff-index --check в хуках препкоммит, она предназначена для проверки на наличие маркеров конфликтов или ошибок в пробелах, таких как пробелы в конце строки или пустые строки в конце файла. Часто возникает ошибка "new blank line at EOF", даже если вы завершаете файлы новой строкой, что вызывает путаницу.
Понимание настройки core.whitespace
Ошибки пробелов, которые проверяет данная команда, контролируются параметром core.whitespace в Git. По умолчанию, Git предотвратит следующие типы ошибок:
blank-at-eol— пробелы в конце строки.blank-at-eof— пустые строки в конце файла.space-before-tab— пробелы перед табуляцией в начале строки.
Если ошибка возникает из-за пустых строк в конце файла, её можно отключить, изменив параметры конфигурации Git.
Решение проблемы
Для того чтобы перестать получать ошибку "new blank line at EOF" при использовании команды git diff-index --check, выполните следующие шаги:
-
Отключение проверки
blank-at-eof:git config --global core.whitespace -blank-at-eofЭто позволит игнорировать пустые строки в конце файла.
-
Убедитесь, что ваш хук препкоммит правильно настроен:
Если вы хотите, чтобыgit diff-index --checkигнорировал пустые строки, убедитесь в наличии добавления опции--ignore-blank-linesв хук, как уже было указано:sed -i'' 's/diff-index --check/\0 --ignore-blank-lines/g' ".git/hooks/pre-commit"
Осознание использования параметров
Следует понимать, что отключение одного из проверяемых параметров core.whitespace изменяет метод контроля ошибок пробелов в проекте. Это может быть полезно, если пустая строка в конце файла является нормой в вашем проекте или если это часть принимаемого кодирования стайла.
Заключение
В точном соблюдении рекомендаций по проверке пробелов кроется успех в поддержании чистоты кода. Отключив blank-at-eof, вы сможете облегчить процесс работы с Git, но всегда следует придерживаться принятого стиля кодирования и командных соглашений в вашем проекте. Это позволит избежать не только ошибочных предупреждений, но и обеспечит единообразие кода.