我想重命名/移动Git中的项目子树/项目/xyz到/组件/xyz如果我使用普通的gitmv项目组件，那么xyz项目的所有提交历史都会丢失。

没有（8年后，Git 2.19，2018年第3季度），因为Git会检测到目录重命名，现在已经有了更好的记录。

参见Elijah Newren（Newren）提交的提交b00bf1c、提交1634688、提交0661e49、提交4d34dff、提交983f464、提交c840e1a、提交9929430（2018年6月27日）和提交d4e8062、提交5dacd4a（2018年7月25日）。（于2018年7月24日由Junio C Hamano（吉斯特）在提交时合并）

现在在Documentation/technical/directory-rename-detection.txt中对此进行了解释：

例子：

当所有x/a、x/b和x/c都移动到z/a、z/b和z/c时，很可能同时添加的x/d也希望通过以下方式移动到z/d提示整个目录“x”移动到“z”。

但还有很多其他情况，比如：

历史的一方重命名为x->z，另一方将某个文件重命名为x/e，导致合并需要进行传递重命名。

为了简化目录重命名检测，这些规则由Git强制执行：

当应用目录重命名检测：

如果合并的两边仍然存在给定的目录，我们不认为它已被重命名。如果要重命名的文件的子集有一个文件或目录在其中（或将相互妨碍），请“关闭”这些特定子路径的目录重命名，并向用户报告冲突。如果历史的另一端将目录重命名为您的历史的另一侧重命名的路径，那么对于任何隐式目录重命名，忽略历史另一端的特定重命名（但警告用户）。

您可以在t/t6043-merge-rename-directories.sh中看到许多测试，其中还指出：

a） 如果重命名将一个目录拆分为两个或多个其他目录，则重命名最多的目录“获胜”。b） 避免对路径进行目录重命名检测，如果该路径是合并两侧重命名的源。c） 仅在另一侧对目录应用隐式目录重命名历史是一个做更名的人。

我想重命名/移动Git中的项目子树/项目/xyz到/组件/xyz如果我使用普通的gitmv项目组件，那么xyz项目的所有提交历史都会丢失。

没有（8年后，Git 2.19，2018年第3季度），因为Git会检测到目录重命名，现在已经有了更好的记录。

参见Elijah Newren（Newren）提交的提交b00bf1c、提交1634688、提交0661e49、提交4d34dff、提交983f464、提交c840e1a、提交9929430（2018年6月27日）和提交d4e8062、提交5dacd4a（2018年7月25日）。（于2018年7月24日由Junio C Hamano（吉斯特）在提交时合并）

现在在Documentation/technical/directory-rename-detection.txt中对此进行了解释：

例子：

当所有x/a、x/b和x/c都移动到z/a、z/b和z/c时，很可能同时添加的x/d也希望通过以下方式移动到z/d提示整个目录“x”移动到“z”。

但还有很多其他情况，比如：

历史的一方重命名为x->z，另一方将某个文件重命名为x/e，导致合并需要进行传递重命名。

为了简化目录重命名检测，这些规则由Git强制执行：

当应用目录重命名检测：

如果合并的两边仍然存在给定的目录，我们不认为它已被重命名。如果要重命名的文件的子集有一个文件或目录在其中（或将相互妨碍），请“关闭”这些特定子路径的目录重命名，并向用户报告冲突。如果历史的另一端将目录重命名为您的历史的另一侧重命名的路径，那么对于任何隐式目录重命名，忽略历史另一端的特定重命名（但警告用户）。

您可以在t/t6043-merge-rename-directories.sh中看到许多测试，其中还指出：

a） 如果重命名将一个目录拆分为两个或多个其他目录，则重命名最多的目录“获胜”。b） 避免对路径进行目录重命名检测，如果该路径是合并两侧重命名的源。c） 仅在另一侧对目录应用隐式目录重命名历史是一个做更名的人。

首先，只需重命名即可创建独立提交。

然后，对文件内容的任何最终更改都将放在单独的提交中。

可以重命名文件并保持历史记录不变，尽管这会导致文件在存储库的整个历史记录中被重命名。这可能只适用于痴迷于git日志的爱好者，并有一些严重的影响，包括：

您可以重写共享历史，这是使用Git时最重要的“不要”。如果其他人克隆了存储库，您将通过此操作将其破坏。他们将不得不重新克隆以避免头痛。如果重命名足够重要，这可能是可以的，但您需要仔细考虑这一点——您可能会扰乱整个开源社区！如果您在存储库历史记录的早期使用文件的旧名称引用了该文件，那么实际上就是在破坏早期版本。为了解决这个问题，你必须多跳一点环跳。这不是不可能的，只是乏味而且可能不值得。

现在，既然你还和我在一起，你可能是一个单独的开发人员，正在重命名一个完全独立的文件。让我们使用过滤器树移动文件！

假设您要将一个旧文件移动到文件夹目录中，并将其命名为new

这可以用git-mv-old-dir/new&&git-add-u-dir/new来完成，但这打破了历史。

相反：

git filter-branch --tree-filter 'if [ -f old ]; then mkdir dir && mv old dir/new; fi' HEAD

将重做分支中的每个提交，在每个迭代的滴答声中执行命令。当你这样做的时候，很多事情都会出错。我通常会测试文件是否存在（否则它还没有移动），然后执行必要的步骤，按照我的喜好强行插入树。在这里，您可能会浏览文件以更改对文件的引用等等

完成后，文件将被移动，日志将完好无损。你觉得自己像忍者海盗。

而且当然，只有当您将文件移动到新文件夹时，mkdir目录才是必需的。if将避免在文件存在之前创建此文件夹。

Git检测重命名，而不是通过提交持久化操作，因此使用gitmv还是mv并不重要。

log命令采用--follow参数，该参数在重命名操作之前继续历史，即，它使用启发式搜索类似的内容。

要查找完整的历史记录，请使用以下命令：

git log --follow ./path/to/file

要重命名目录或文件（我不太了解复杂的情况，因此可能需要注意）：

git filter-repo --path-rename OLD_NAME:NEW_NAME

要在提到目录的文件中重命名目录（可以使用回调，但我不知道如何）：

git filter-repo --replace-text expressions.txt

expressions.txt是一个充满了文字：OLD_NAME==>NEW_NAME等行的文件（可以将Python的RE与regex一起使用，也可以将glob与glob一起使用）。

要重命名提交消息中的目录，请执行以下操作：

git-filter-repo --message-callback 'return message.replace(b"OLD_NAME", b"NEW_NAME")'

Python的正则表达式也受支持，但必须用Python手动编写。

如果存储库是原始的，没有远程，则必须添加--force以强制重写。（在执行此操作之前，您可能需要创建存储库的备份。）

如果不想保留引用（它们将显示在GitGUI的分支历史记录中），则必须添加--replace-refs delete no add。