我在名为 XXX 的文件夹中有一个 Git 存储库，我还有第二个名为 YYY 的 Git 存储库。
我想将 XXX 存储库作为名为 ZZZ 的子目录导入到 YYY 存储库并添加所有 XXX 的更改历史记录为 YYY。
之前的文件夹结构：
├── XXX
│ ├── .git
│ └── (project files)
└── YYY
├── .git
└── (project files)
之后的文件夹结构：
YYY
├── .git <-- This now contains the change history from XXX
├── ZZZ <-- This was originally XXX
│ └── (project files)
└── (project files)
这可以做到吗，还是我必须求助于使用子模块？
【问题讨论】：
这是可以立即运行的脚本。
#!/bin/bash -xe
# script name: merge-repo.sh
# To merge repositories into the current.
# To see the log of the new repo use 'git log --follow -- unprefixed-filename'
# So if the file is repo/test.cpp use 'git log --follow -- test.cpp'
# I'm not sure how this will work when two files have the same name.
#
# `git branch -a` will show newly created branches.
# You can delete them if you want.
merge_another() {
repo="$1" # url of the remote repo
rn="$2" # new name of the repo, you can keep the same name as well.
git remote add ${rn} ${repo}
git fetch ${rn}
git merge -s ours --no-commit --allow-unrelated-histories ${rn}/master
git read-tree --prefix=${rn}/ -u ${rn}/master
git commit -m "Imported ${rn} as a subtree."
git pull -s subtree ${rn} master
}
merge_another $1 $2
运行脚本。转到您希望合并其他 repo 的 repo，然后运行脚本。
cd base-repo
./merge-repo.sh git@github.com:username/repo-to-be-merged.git repo-to-be-merged-new-name
现在将主分支上的更改推送到远程/源。根据您要执行的操作，可能不需要此步骤。
git push origin master
【讨论】：
没有足够的代表来为 x-yuri 的答案添加评论，但它工作得很好并且保留了历史。 我正在使用两个有效的本地仓库并收到此错误：
Aborting：拒绝破坏性地覆盖回购历史，因为 这看起来不像是一个新的克隆。 （预计新包装的回购） 请改为对新克隆进行操作。如果您仍想继续，请使用 --force。
我没有担心--force 标志的含义，而是首先在本地克隆了repo：
cd tempDir
git clone <location of repo to be merged> --no-local
并将这个新克隆的副本用于 x-yuri 布置的一系列命令。
最后，在：git filter-repo --to-subdirectory-filter a，a 是您为要导入的 repo 的根文件夹指定的名称。
【讨论】：
git-subtree 是专为这种将多个存储库合并为一个同时保留历史记录（和/或拆分子树的历史记录，尽管这似乎与这个问题无关）的用例而设计的脚本。它作为 git 树 since release 1.7.11 的一部分分发。
要将修订版<rev> 的存储库<repo> 合并为子目录<prefix>，请使用git subtree add，如下所示：
git subtree add -P <prefix> <repo> <rev>
git-subtree 以更加用户友好的方式实现subtree merge strategy。
对于您的情况，在存储库 YYY 中，您将运行：
git subtree add -P ZZZ /path/to/XXX.git master
缺点是在合并的历史中文件没有前缀（不在子目录中）。结果，git log ZZZ/a 将向您显示所有更改（如果有），但合并历史记录中的更改除外。你可以这样做：
git log --follow -- a
但这不会在合并的历史记录中显示其他更改。
换句话说，如果您不更改存储库XXX 中ZZZ 的文件，那么您需要指定--follow 和一个不带前缀的路径。如果您在两个存储库中更改它们，那么您有 2 个命令，其中没有一个显示所有更改。
更多信息here。
【讨论】：
git subtree add -P name-of-desired-prefix ~/location/of/git/repo-without-.git branch-name
如果您想保留第二个存储库的确切提交历史记录，并因此还保留将来轻松合并上游更改的能力，那么这就是您想要的方法。它会导致未修改的子树历史被导入到您的存储库中，加上一个合并提交以将合并的存储库移动到子目录。
git remote add XXX_remote <path-or-url-to-XXX-repo>
git fetch XXX_remote
git merge -s ours --no-commit --allow-unrelated-histories XXX_remote/master
git read-tree --prefix=ZZZ/ -u XXX_remote/master
git commit -m "Imported XXX as a subtree."
您可以像这样跟踪上游更改：
git pull -s subtree XXX_remote master
Git 在进行合并之前会自行确定根的位置，因此您无需在后续合并中指定前缀。
缺点是在合并的历史中文件没有前缀（不在子目录中）。因此，git log ZZZ/a 将向您显示所有更改（如果有），但合并历史记录中的更改除外。你可以这样做：
git log --follow -- a
但这不会在合并历史记录中显示其他更改。
换句话说，如果您不更改存储库XXX 中的ZZZ 的文件，那么您需要指定--follow 和一个不带前缀的路径。如果您在两个存储库中更改它们，那么您有 2 个命令，其中没有一个显示所有更改。
2.9 之前的 Git 版本：您无需将 --allow-unrelated-histories 选项传递给 git merge。
另一个答案中使用 read-tree 并跳过 merge -s ours 步骤的方法实际上与使用 cp 复制文件并提交结果没有什么不同。
原始来源来自github's "Subtree Merge" help article。还有another useful link。
【讨论】：
git log，我只会看到单个合并提交，而它在其他回购？ Git 1.8.0
git log -- myfile 而不是 git log -- rack/myfile
--allow-unrelated-histories 选项。
让我使用名称a（代替XXX 和ZZZ）和b（代替YYY），因为这样会使说明更易于阅读。
假设您要将存储库 a 合并到 b（我假设它们彼此并排）：
cd a
git filter-repo --to-subdirectory-filter a
cd ..
cd b
git remote add a ../a
git fetch a
git merge --allow-unrelated-histories a/master
git remote remove a
为此，您需要安装 git-filter-repo（filter-branch 是 discouraged）。
合并 2 个大存储库的示例，将其中一个放入子目录：https://gist.github.com/x-yuri/9890ab1079cf4357d6f269d073fd9731
更多信息here。
【讨论】：
git subtree add -P ... 的解决方案不同，历史记录出现在git log 中没有问题。
我可以针对您的问题提出另一种解决方案（git-submodules 的替代方案） - gil (git links) tool
它允许描述和管理复杂的 git 存储库依赖项。
它还为git recursive submodules dependency problem 提供了解决方案。
假设您有以下项目依赖项： sample git repository dependency graph
然后你可以定义.gitlinks文件和repositories关系描述：
# Projects
CppBenchmark CppBenchmark https://github.com/chronoxor/CppBenchmark.git master
CppCommon CppCommon https://github.com/chronoxor/CppCommon.git master
CppLogging CppLogging https://github.com/chronoxor/CppLogging.git master
# Modules
Catch2 modules/Catch2 https://github.com/catchorg/Catch2.git master
cpp-optparse modules/cpp-optparse https://github.com/weisslj/cpp-optparse.git master
fmt modules/fmt https://github.com/fmtlib/fmt.git master
HdrHistogram modules/HdrHistogram https://github.com/HdrHistogram/HdrHistogram_c.git master
zlib modules/zlib https://github.com/madler/zlib.git master
# Scripts
build scripts/build https://github.com/chronoxor/CppBuildScripts.git master
cmake scripts/cmake https://github.com/chronoxor/CppCMakeScripts.git master
每一行用以下格式描述 git 链接：
最后，您必须更新您的根示例存储库：
# Clone and link all git links dependencies from .gitlinks file
gil clone
gil link
# The same result with a single command
gil update
因此，您将克隆所有必需的项目并以适当的方式将它们相互链接。
如果您想提交某个存储库中的所有更改以及子链接存储库中的所有更改，您可以使用单个命令完成：
gil commit -a -m "Some big update"
拉、推命令的工作方式类似：
gil pull
gil push
Gil（git links）工具支持以下命令：
usage: gil command arguments
Supported commands:
help - show this help
context - command will show the current git link context of the current directory
clone - clone all repositories that are missed in the current context
link - link all repositories that are missed in the current context
update - clone and link in a single operation
pull - pull all repositories in the current directory
push - push all repositories in the current directory
commit - commit all repositories in the current directory
【讨论】：
可能最简单的方法是将 XXX 东西拉到 YYY 的一个分支中，然后将其合并到 master 中：
在YYY：
git remote add other /path/to/XXX
git fetch other
git checkout -b ZZZ other/master
mkdir ZZZ
git mv stuff ZZZ/stuff # repeat as necessary for each file/dir
git commit -m "Moved stuff to ZZZ"
git checkout master
git merge ZZZ --allow-unrelated-histories # should add ZZZ/ to master
git commit
git remote rm other
git branch -d ZZZ # to get rid of the extra branch before pushing
git push # if you have a remote, that is
实际上，我只是用我的几个存储库尝试了这个，它可以工作。与 Jörg's answer 不同，它不会让您继续使用其他 repo，但我认为您无论如何都没有指定。
注意：由于这最初是在 2009 年编写的，因此 git 添加了下面答案中提到的子树合并。我今天可能会使用这种方法，尽管这种方法当然仍然有效。
【讨论】：
git mv $(ls|grep -v <your foldername>) <your foldername>/ 这会将所有文件和文件夹复制到您的新文件夹中
此功能会将远程仓库克隆到本地仓库目录，合并后所有提交将被保存，git log 将显示原始提交和正确路径：
function git-add-repo
{
repo="$1"
dir="$(echo "$2" | sed 's/\/$//')"
path="$(pwd)"
tmp="$(mktemp -d)"
remote="$(echo "$tmp" | sed 's/\///g'| sed 's/\./_/g')"
git clone "$repo" "$tmp"
cd "$tmp"
git filter-branch --index-filter '
git ls-files -s |
sed "s,\t,&'"$dir"'/," |
GIT_INDEX_FILE="$GIT_INDEX_FILE.new" git update-index --index-info &&
mv "$GIT_INDEX_FILE.new" "$GIT_INDEX_FILE"
' HEAD
cd "$path"
git remote add -f "$remote" "file://$tmp/.git"
git pull "$remote/master"
git merge --allow-unrelated-histories -m "Merge repo $repo into master" --edit "$remote/master"
git remote remove "$remote"
rm -rf "$tmp"
}
使用方法：
cd current/package
git-add-repo https://github.com/example/example dir/to/save
如果进行一些更改，您甚至可以将合并 repo 的文件/目录移动到不同的路径中，例如：
repo="https://github.com/example/example"
path="$(pwd)"
tmp="$(mktemp -d)"
remote="$(echo "$tmp" | sed 's/\///g' | sed 's/\./_/g')"
git clone "$repo" "$tmp"
cd "$tmp"
GIT_ADD_STORED=""
function git-mv-store
{
from="$(echo "$1" | sed 's/\./\\./')"
to="$(echo "$2" | sed 's/\./\\./')"
GIT_ADD_STORED+='s,\t'"$from"',\t'"$to"',;'
}
# NOTICE! This paths used for example! Use yours instead!
git-mv-store 'public/index.php' 'public/admin.php'
git-mv-store 'public/data' 'public/x/_data'
git-mv-store 'public/.htaccess' '.htaccess'
git-mv-store 'core/config' 'config/config'
git-mv-store 'core/defines.php' 'defines/defines.php'
git-mv-store 'README.md' 'doc/README.md'
git-mv-store '.gitignore' 'unneeded/.gitignore'
git filter-branch --index-filter '
git ls-files -s |
sed "'"$GIT_ADD_STORED"'" |
GIT_INDEX_FILE="$GIT_INDEX_FILE.new" git update-index --index-info &&
mv "$GIT_INDEX_FILE.new" "$GIT_INDEX_FILE"
' HEAD
GIT_ADD_STORED=""
cd "$path"
git remote add -f "$remote" "file://$tmp/.git"
git pull "$remote/master"
git merge --allow-unrelated-histories -m "Merge repo $repo into master" --edit "$remote/master"
git remote remove "$remote"
rm -rf "$tmp"
通知
路径通过sed 替换，因此请确保它在合并后移动到正确的路径中。--allow-unrelated-histories 参数仅在 git >= 2.9 后才存在。
【讨论】：
gnu-sed 以使 git-add-repo 功能正常工作。再次感谢安德烈！
在 Git 存储库本身中有一个众所周知的实例，在 Git 社区中统称为“the coolest merge ever”（在发送给 Git 邮件列表的电子邮件中使用的主题行 Linus Torvalds 之后描述了这个合并）。在这种情况下，gitk Git GUI 现在是 Git 本身的一部分，实际上曾经是一个单独的项目。 Linus 设法将该存储库合并到 Git 存储库中
git pulled 进行更改。这封电子邮件包含了重现所需的步骤，但它不适合胆小的人：首先，Linus 编写 Git，所以他可能比你或我更了解它，其次，这几乎是 5 年前的事了，从那时起 Git 有了相当大的改进，所以现在可能要容易得多。
特别是，我想现在人们会在这种特定情况下使用 gitk 子模块。
【讨论】：
git-subtree 工具可以帮助您：github.com/apenwarr/git-subtree
subtree 合并策略，尤其是与 git-subtree 工具结合使用是一个不错的，甚至可能是子模块的更好替代方案。
请参阅this article 中的基本示例，并考虑在存储库上进行此类映射：
A YYY, B XXX
在本章描述的所有活动之后（合并后），删除分支B-master：
$ git branch -d B-master
然后，推送更改。
它对我有用。
【讨论】：
基于on this article，使用子树对我有用，并且只传输了适用的历史记录。如果有人需要这些步骤，请在此处发布（确保将占位符替换为适用于您的值）：
在您的源存储库中将子文件夹拆分为一个新分支
git subtree split --prefix=<source-path-to-merge> -b subtree-split-result
在你的目标 repo 中合并拆分结果分支
git remote add merge-source-repo <path-to-your-source-repository>
git fetch merge-source-repo
git merge -s ours --no-commit merge-source-repo/subtree-split-result
git read-tree --prefix=<destination-path-to-merge-into> -u merge-source-repo/subtree-split-result
验证您的更改并提交
git status
git commit
别忘了
通过删除subtree-split-result 分支进行清理
git branch -D subtree-split-result
删除您添加的远程以从源 repo 获取数据
git remote rm merge-source-repo
【讨论】：
我当时正在寻找-s theirs，但当然，这种策略不存在。我的历史是我在 GitHub 上分叉了一个项目，现在由于某种原因，我的本地 master 无法与 upstream/master 合并，尽管我没有对这个分支进行本地更改。 （真的不知道那里发生了什么——我猜上游在幕后做了一些肮脏的推动，也许吧？）
我最终做的是
# as per https://help.github.com/articles/syncing-a-fork/
git fetch upstream
git checkout master
git merge upstream/master
....
# Lots of conflicts, ended up just abandonging this approach
git reset --hard # Ditch failed merge
git checkout upstream/master
# Now in detached state
git branch -d master # !
git checkout -b master # create new master from upstream/master
所以现在我的master 再次与upstream/master 同步（您可以对您也想类似同步的任何其他分支重复上述操作）。
【讨论】：
master 分支上的git reset --hard upstream/master 可以完成这项工作。这样你就不会丢失本地分支配置——比如默认的上游。
添加另一个答案，因为我认为这更简单。将 repo_dest 拉入到 repo_to_import 中，然后进行 push --set-upstream url:repo_dest master。
这种方法对我将几个较小的存储库导入到一个较大的存储库中很有效。
如何导入：repo1_to_import 到 repo_dest
# checkout your repo1_to_import if you don't have it already
git clone url:repo1_to_import repo1_to_import
cd repo1_to_import
# now. pull all of repo_dest
git pull url:repo_dest
ls
git status # shows Your branch is ahead of 'origin/master' by xx commits.
# now push to repo_dest
git push --set-upstream url:repo_dest master
# repeat for other repositories you want to import
在进行导入之前，将文件和目录重命名或移动到原始存储库中的所需位置。例如
cd repo1_to_import
mkdir topDir
git add topDir
git mv this that and the other topDir/
git commit -m"move things into topDir in preparation for exporting into new repo"
# now do the pull and push to import
以下链接中描述的方法启发了这个答案。我喜欢它，因为它看起来更简单。但当心！有龙！ https://help.github.com/articles/importing-an-external-git-repository git push --mirror url:repo_dest 将本地仓库历史和状态推送到远程（url:repo_dest）。但它删除了遥控器的旧历史和状态。乐趣随之而来！ :-E
【讨论】：
就我而言，我只想从其他存储库 (XXX) 导入一些文件。子树对我来说太复杂了，其他解决方案都不起作用。这就是我所做的：
ALL_COMMITS=$(git log --reverse --pretty=format:%H -- ZZZ | tr '\n' ' ')
这为您提供了一个以空格分隔的列表，其中列出了影响我要导入的文件 (ZZZ) 的所有提交（您可能还必须添加 --follow 以捕获重命名）。然后我进入目标存储库（YYY），将另一个存储库（XXX）添加为远程，从中获取，最后：
git cherry-pick $ALL_COMMITS
它将所有提交添加到您的分支，因此您将拥有所有文件及其历史记录，并且可以对它们做任何您想做的事情，就好像它们一直在这个存储库中一样。
【讨论】：
执行此操作的简单方法是使用 git format-patch。
假设我们有 2 个 git 存储库 foo 和 bar。
foo 包含：
条形包含：
我们希望以包含 bar 历史记录和这些文件的 foo 结尾：
所以这样做：
1. create a temporary directory eg PATH_YOU_WANT/patch-bar
2. go in bar directory
3. git format-patch --root HEAD --no-stat -o PATH_YOU_WANT/patch-bar --src-prefix=a/foobar/ --dst-prefix=b/foobar/
4. go in foo directory
5. git am PATH_YOU_WANT/patch-bar/*
如果我们想重写 bar 中的所有消息提交，我们可以这样做，例如在 Linux 上：
git filter-branch --msg-filter 'sed "1s/^/\[bar\] /"' COMMIT_SHA1_OF_THE_PARENT_OF_THE_FIRST_BAR_COMMIT..HEAD
这将在每条提交消息的开头添加“[bar]”。
【讨论】：
git am 可能会失败。
[ ] 中的任何内容。所以你应该使用不同于[bar]的标记
我不知道有什么简单的方法可以做到这一点。你可以这样做：
如果这听起来很吸引人，我可以编辑细节。
【讨论】：
我认为你可以使用 'git mv' 和 'git pull' 来做到这一点。
我是一个公平的 git noob - 所以要小心你的主存储库 - 但我只是在临时目录中尝试过这个，它似乎工作。
首先 - 重命名 XXX 的结构以匹配它在 YYY 中时的外观：
cd XXX
mkdir tmp
git mv ZZZ tmp/ZZZ
git mv tmp ZZZ
现在 XXX 看起来像这样：
XXX
|- ZZZ
|- ZZZ
现在使用 'git pull' 来获取更改：
cd ../YYY
git pull ../XXX
现在 YYY 看起来像这样：
YYY
|- ZZZ
|- ZZZ
|- (other folders that already were in YYY)
【讨论】：