简体中文 ▾ 主题 ▾ 最新版本 ▾ 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] 套件的一部分