签出 Git 中的子目录？

Question

是否可以在 Git 中查看存储库的子目录？

想象一下我正在设置一个新的 WordPress 安装。 我将为我的插件和主题自定义创建两个新目录：

• wordpress/wp-content/plugins/myplugins/
• wordpress/wp-content/themes/mytheme/

我想要通过 Git 维护这些目录。 在 Subversion 中，我将通过拥有 trunk/myplugins/ 和 trunk/mytheme/ 目录并签出子目录来实现此目的。 Git 是否有办法使用单个存储库完成相同的任务？

作为一个很少接触 Git 的长期 SVN 用户，我可能只是错过了一些 Git 范例。

编辑：多个分支存储不同的内容是一个处理这个问题的有趣方法。

Answer 1

稀疏结账是现在使用 Git 1.7。

另请参阅问题“是否可以在不先检出整个存储库的情况下进行稀疏检出？”。

请注意，稀疏签出仍然需要您下载整个存储库，即使 Git 下载的某些文件最终不会出现在您的工作树中。

Answer 2

git clone --filter + git稀疏-checkout 仅下载所需的文件

例如，仅克隆子目录 small/< 中的文件/code> 在此测试存储库中： https://github .com/cirosantilli/test-git-partial-clone-big-small-no-bigtree

git clone -n --depth=1 --filter=tree:0 \
  https://github.com/cirosantilli/test-git-partial-clone-big-small-no-bigtree
cd test-git-partial-clone-big-small-no-bigtree
git sparse-checkout set --no-cone small
git checkout

此选项是与远程协议的更新一起添加的，它确实可以防止从服务器下载对象。

我已在以下位置更详细地介绍了这一点： 如何仅克隆 Git 存储库的子目录？

已于 2021 年 1 月在 git 2.30.0 上进行测试。

Answer 3

在 git 中没有真正的方法可以做到这一点。 如果您不会进行同时影响两个树作为单个工作单元的更改，则没有充分的理由为两个树使用单个存储库。 我以为我会错过这个 Subversion 功能，但我发现创建存储库的管理心理开销非常小（仅仅是因为存储库存储在其工作副本旁边，而不是要求我明确选择存储库之外的某个位置）工作副本），我习惯于制作大量小型的单一用途存储库。

不过，如果您坚持（或确实需要），您可以创建一个仅包含 mytheme 和 myplugins 目录的 git 存储库，并在 WordPress 安装中对它们进行符号链接。

---

MDCore 写道:

提交例如mytheme将增加myplugin的修订号

请注意，如果您决定将两个目录放在一个目录中，这不是 git 关心的问题存储库，因为 git 完全消除了任何形式的单调递增修订号的概念。

git 中将哪些内容放在单个存储库中的唯一标准是它是否构成单个单元，即。 在您的情况下，是否存在单独查看每个目录中的编辑没有意义的更改。 如果您需要同时编辑两个目录中的文件并且编辑内容属于同一目录，那么它们应该是一个存储库。 如果没有，那就不要把它们混在一起。

Git 确实希望您为不同的实体使用单独的存储库。

子模块

子模块不能满足将两个目录保留在一个存储库中的愿望，因为它们实际上会强制每个目录都有一个单独的存储库，然后使用子模块将它们汇集到另一个存储库中。 更糟糕的是，由于 WordPress 安装中的目录不是同一目录的直接子目录，而且也是包含许多其他文件的层次结构的一部分，因此使用每个目录存储库作为统一存储库中的子模块不会带来任何好处，因为统一的存储库不会提供任何好处。存储库不会反映任何用例/需求。

Answer 4

我不喜欢稀疏签出的一件事是，如果您想签出几个目录深的子目录，您的目录结构必须包含通向它的所有目录。

我解决此问题的方法是将存储库克隆到不是我的工作区的位置，然后在我的工作区目录中创建到存储库中的子目录的符号链接。 Git 的工作方式非常好，因为像 git status 这样的东西会显示相对于当前工作目录的更改文件。

Answer 5

事实上，“窄”或“部分”或“稀疏”签出目前正在为 Git 进行大量开发。 请注意，您仍然在 .git 下拥有完整的存储库。 因此，另外两篇文章是当前 Git 状态的最新文章，但看起来我们最终将能够进行稀疏签出。 如果您对更多详细信息感兴趣，查看邮件列表 --他们正在迅速变化。

Answer 6

正如您的编辑所指出的，您可以使用两个单独的分支来存储两个单独的目录。 这确实将它们保留在同一个存储库中，但您仍然无法跨两个目录树进行提交。 如果您对一个目录的更改需要对另一个目录进行更改，则必须将它们作为两个单独的提交来执行，并且您打开了两个目录的一对检出可能不同步的可能性。

如果您想将这对目录视为一个单元，您可以使用“wordpress/wp-content”作为存储库的根目录，并在顶层使用 .gitignore 文件来忽略除感兴趣的两个子目录之外的所有内容。 这可能是目前最合理的解决方案。

据称，稀疏检查已经出现两年了，但在 git 开发仓库中仍然没有任何迹象，也没有任何迹象表明必要的更改将会到达那里。 我不会指望他们。

Answer 7

您无法签出存储库的单个目录，因为整个存储库是由项目根目录中的单个 .git 文件夹处理的，而不是 subversion 的无数 .svn 目录。

在单个存储库中处理插件的问题是，提交例如 mytheme 会增加 myplugin 的修订号，因此即使在 subversion 中也最好使用单独的存储库。

子项目的颠覆范例是 svn:externals ，它有点翻译到 git 中的 子模块 （但不完全是在你使用过 svn 的情况下：之前的外部。）

Answer 8

这里有一个灵感。 只需使用 shell regex 或 git regex。

git checkout commit_id */*.bat  # *.bat in 1-depth subdir exclude current dir, shell regex  
git checkout commit_id '*.bat'  # *.bat in all subdir include current dir, git regex

使用引号转义 shell 正则表达式解释并将通配符传递给 git。

第一个是不是递归的，仅是 1 深度 subdir 中的文件。 但第二个是递归的。

对于您的情况，以下内容可能就足够了。

git checkout master */*/wp-content/*/*
git checkout master '*/wp-content/*'

只需根据需要修改线路即可。

Answer 9

我查看了不同的响应，包括来自 How我是否只克隆 Git 存储库的子目录？

它们并不是非常简单的答案，因此我决定编写一个小型 shell 脚本来帮助简化该过程。
请参阅 https://gist.github.com/hiranp/a26e334369386211709f4846929a6157

#!/bin/env bash

# This script clones the remote repository using the --filter=blob:none option to avoid downloading any file contents. 
#   It then checks out the specified remote branch and enables sparse-checkout. The sparse-checkout pattern is set to only 
#   include the desired folder, and finally, the latest changes are pulled from the remote branch.

# NOTE: 
# Customize this script by setting the REMOTE_REPO_URL, REMOTE_BRANCH, GIT_FOLDER_PATH, and LOCAL_REPO_PATH variables.

# Set the remote repository URL
REMOTE_REPO_URL="<URL>"

# Set the remote branch name
REMOTE_BRANCH="branch-name"

# Set the path to the folder you want to copy
GIT_FOLDER_PATH="path/to/folder"

# Set the path to the local repository
LOCAL_REPO_PATH="path/to/local/repo"

echo "Cloning the remote repository...to ${LOCAL_REPO_PATH}"
if [ ! -d "${LOCAL_REPO_PATH}" ]; then
    mkdir -p "${LOCAL_REPO_PATH}"
    # Shadow clone the remote repository
    git clone --depth 1 --no-checkout --filter=blob:none "${REMOTE_REPO_URL}" "${LOCAL_REPO_PATH}"
fi

# Change to the repository directory
cd "${LOCAL_REPO_PATH}"

# Checkout the remote branch
git checkout "${REMOTE_BRANCH}"

if [ ! -f ".git/info/sparse-checkout" ]; then
    # Enable sparse-checkout
    git sparse-checkout init

    # Set the sparse-checkout pattern to only include the desired folder
    git sparse-checkout set "${LOCAL_REPO_PATH}"
fi

# Pull the latest changes from the remote branch
git pull origin "${REMOTE_BRANCH}"

Answer 10

您可以仅恢复对特定文件或目录的未提交更改：

git checkout [some_dir|file.txt]