簡體中文 ▾ 主題 ▾ 最新版本 ▾ git-mv 最後更新於 2.50.0

名稱

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 設定，以使子模組在新位置正常工作。它還會嘗試更新 gitmodules[5] 檔案中的 submodule.<name>.path 設定，並暫存該檔案（除非使用了 -n）。

BUG

每次父專案更新移動一個已填充的子模組時（例如，在移動發生之前和之後的提交之間切換時），舊位置會留下一個過時的子模組簽出，新位置會出現一個空目錄。要再次在新位置填充子模組，使用者必須稍後執行“git submodule update”。僅當舊目錄使用 gitfile 時，刪除舊目錄才是安全的，否則子模組的歷史記錄也會被刪除。當遞迴子模組更新實現後，這兩個步驟都將成為多餘的。

GIT

Git[1] 套件的一部分