Git
English ▾ 主題 ▾ 最新版本 ▾ git-mv 最後更新於 2.44.0

名稱

git-mv - 移動或重新命名檔案、目錄或符號連結

概要

git mv [<options>] <source>…​ <destination>

描述

移動或重新命名檔案、目錄或符號連結。

git mv [-v] [-f] [-n] [-k] <source> <destination>
git mv [-v] [-f] [-n] [-k] <source> ... <destination-directory>

在第一種形式中,它會將必須存在且為檔案、符號連結或目錄的 <來源> 重新命名為 <目的地>。在第二種形式中,最後一個參數必須是現有的目錄;指定的來源將會被移動到此目錄中。

索引在成功完成後會更新,但變更仍然必須提交。

選項

-f
--force

強制重新命名或移動檔案,即使 <目的地> 存在。

-k

跳過會導致錯誤情況的移動或重新命名動作。當來源既不存在也不受 Git 控制時,或者當它會覆寫現有檔案(除非指定 -f)時,會發生錯誤。

-n
--dry-run

不做任何事;僅顯示會發生的事情

-v
--verbose

在移動檔案時報告檔案名稱。

子模組

使用 gitfile 移動子模組(表示它們是用 Git 1.7.8 或更新版本複製的)將會更新 gitfile 和 core.worktree 設定,使子模組在新位置運作。它也會嘗試更新 gitmodules[5] 檔案中的 submodule.<name>.path 設定,並暫存該檔案(除非使用 -n)。

錯誤

每次超專案更新移動已填入的子模組時(例如,在移動之前和之後的提交之間切換時),過時的子模組結帳將會保留在舊位置,而空目錄將會出現在新位置。若要再次在新位置填入子模組,使用者必須在之後執行「git submodule update」。僅當舊目錄使用 gitfile 時移除舊目錄才是安全的,否則子模組的歷史記錄也會被刪除。當遞迴子模組更新實作後,這兩個步驟都將會過時。

GIT

屬於 git[1] 套件的一部分

scroll-to-top