如何在 Github 上创建仓库，这属于 Git 的入门知识，此处不再赘述。

需要注意的是，你不能只创建“空的”远程仓库，每一个远程仓库都必须至少包含一次提交，也就是说远程仓库里得有历史记录，得有 refs（至少得有 master 分支的引用），这样后面添加子树的操作才能成功，否则会报错的（找不到可用的 refs，即引用）。

典型的操作过程是我们先初始化远程仓库，然后初始化本地仓库，接着绑定 remote 关系 -> 做一次 commit -> 最后 push。

示例：

mkdir project && cd project

git init && git remote add origin https://github.com/example/project

touch .gitignore && git add .gitignore

git commit -m "Initial project repo" && git push -u origin master

不过呢，使用 Github 创建的时候你可以勾选 initialize this repository with a README 选项，这样一来可以省去上述步骤，二来则可以不用在本地单独创建子项目的仓库。

三个仓库都创建好之后，你会拥有如下三个远程仓库的地址：

https://github.com/example/project.git

https://github.com/example/project-client.git

https://github.com/example/project-server.git

这就是我们所需要的前置准备工作。

简单的：

git clone https://github.com/example/project.git

完事儿。

subtree 是子树的子命令

add 则是子树子命令的子命令，顾名思义：添加子树

--prefix 选项用于指明子树所对应的子目录，该目录不必事先存在，Git 会自动创建

-P 是这个选项的简写；另外除了 = 之外，也可以用空格分割，如： -P client

后面这一串是指明一个引用的位置：

它可以是一个 commit（用 SHAs 或者基于 HEAD 的相对引用等）

也可以是一个 repository + refs，比如本例所写——其中 refs 可以是分支／标签／提交中的任意一种（在 Git 的概念中引用本身就是一个泛指概念，本来不需要这么啰嗦的说明的，遗憾的是很多人都学了一个半调子……）

总而言之就是要你指明添加子树的时候，从“哪里”开始去寻找子树的历史记录。

长么？其实也就是远程仓库的地址占地方罢了。好消息是这件事情你只需要做一次，但如果你真的觉得不方便，那么也可以使用命名远程仓库，这个特性其实大家都做过：

先 git remote add client https://github.com/example/project-client.git

再 git subtree add --prefix=client client master

搞定。