簡體中文 ▾ 主題 ▾ 最新版本 ▾ 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] 套件的一部分

scroll-to-top