git-mv
Название
git-mv — перемещение или переименование файла, каталога или символической ссылки
Краткое описание
git mv [-v] [-f] [-n] [-k] <source> <destination> git mv [-v] [-f] [-n] [-k] <source>... <destination-directory>
Описание
Перемещает или переименовывает файл, каталог или символическую ссылку.
В первом варианте команда переименовывает <source>, который должен существовать и быть файлом, символической ссылкой или каталогом, в <destination>. Во втором варианте <destination-directory> должен быть существующим каталогом; указанные исходные объекты будут перемещены в этот каталог.
После успешного завершения индекс обновляется, но изменения всё ещё необходимо зафиксировать.
Параметры
-
-f -
--force -
Принудительно переименовать или переместить файл, даже если <destination> уже существует.
-
-k -
Пропускать действия по перемещению или переименованию, которые могут привести к ошибке. Ошибка возникает, если источник не существует и не отслеживается Git либо если он перезапишет существующий файл, если не указан параметр
-f. -
-n -
--dry-run -
Ничего не делать; только показать, что произошло бы
-
-v -
--verbose -
Выводить имена файлов по мере их перемещения.
Подмодули
При перемещении подмодуля, использующего gitfile (то есть клонированного с помощью Git версии 1.7.8 или новее), будут обновлены gitfile и параметр core.worktree, чтобы подмодуль работал в новом расположении. Также будет предпринята попытка обновить параметр submodule.<name>.path в файле gitmodules[5] и добавить этот файл в индекс (если не используется -n).
Ошибки
Каждый раз, когда обновление суперпроекта перемещает заполненный подмодуль (например, при переключении между коммитами до и после перемещения), в старом расположении остаётся устаревшая копия подмодуля, а в новом появляется пустой каталог. Чтобы снова заполнить подмодуль в новом расположении, пользователю потребуется выполнить команду "git submodule update". Удалять старый каталог безопасно только в том случае, если в нём используется gitfile, иначе будет также удалена история подмодуля. Оба этих шага станут ненужными после реализации рекурсивного обновления подмодулей.
mv
© 2005–2026 Linus Torvalds and others
Licensed under the GNU General Public License version 2.
https://git-scm.com/docs/git-mv
