Git如何引用仓库其他子目录文件，检出时保留为普通文件？

可行，下面给你几个实用的实现方案，满足你在仓库/子模块内实现文件关联同步，且克隆后生成普通文件的需求：

方案1：Git属性+自定义过滤器（原生支持） #

利用Git的gitattributes和内容过滤器，实现提交时同步修改到源文件，检出时从源文件同步到目标文件。

操作步骤 #

1. 定义映射关系：在仓库根目录创建file-mappings.txt，记录源文件和目标文件的对应关系：

   install/Documentation/Manual.pdf windows10/doc/Manual.pdf
   install/Documentation/Manual.pdf windows11/doc/Manual.pdf
   

2. 编写同步脚本：
   • 创建smudge-script.sh（检出时同步源文件到目标文件）：

     #!/bin/bash
     target_file=$1
     # 从映射文件找到对应的源文件
     source_file=$(grep "$target_file" file-mappings.txt | awk '{print $1}')
     if [ -n "$source_file" ]; then
         cp "$source_file" "$target_file"
     fi
     

   • 创建clean-script.sh（提交时同步目标文件修改到源文件）：

     #!/bin/bash
     target_file=$1
     source_file=$(grep "$target_file" file-mappings.txt | awk '{print $1}')
     if [ -n "$source_file" ]; then
         cp "$target_file" "$source_file"
         git add "$source_file" # 确保源文件被纳入提交
     fi
     

   • 给脚本加可执行权限：chmod +x smudge-script.sh clean-script.sh
3. 配置Git过滤器：

   git config filter.sync-file.smudge './smudge-script.sh %f'
   git config filter.sync-file.clean './clean-script.sh %f'
   

4. 配置Git属性：在.gitattributes中添加规则，指定目标文件使用自定义过滤器：

   windows10/doc/Manual.pdf filter=sync-file
   windows11/doc/Manual.pdf filter=sync-file
   

方案2：Git钩子脚本 #

通过Git的pre-commit和post-checkout钩子，分别处理提交时的修改同步，以及检出后的文件同步。

操作步骤 #

1. 同样创建file-mappings.txt，内容和方案1一致。
2. 编写pre-commit钩子：替换.git/hooks/pre-commit.sample为以下内容，命名为pre-commit：

   #!/bin/bash
   while read -r source target; do
       # 检查目标文件是否被标记为提交
       if git diff --cached --name-only | grep -q "$target"; then
           cp "$target" "$source"
           git add "$source" # 同步修改到源文件并加入提交
       fi
   done < file-mappings.txt
   exit 0
   

3. 编写post-checkout钩子：替换.git/hooks/post-checkout.sample为以下内容，命名为post-checkout：

   #!/bin/bash
   while read -r source target; do
       cp "$source" "$target" # 检出后从源文件同步到目标文件
   done < file-mappings.txt
   exit 0
   

4. 给钩子加可执行权限：chmod +x .git/hooks/pre-commit .git/hooks/post-checkout

方案3：跨仓库/子模块的处理 #

如果要跨仓库或子模块同步，只需调整映射文件和脚本的路径逻辑：

• 在file-mappings.txt中指定源文件的完整相对路径，比如子模块中的文件：

  submodule-repo/install/Documentation/Manual.pdf windows10/doc/Manual.pdf
  

• 确保脚本能正确定位到跨仓库的源文件（子模块需已克隆到本地）。

关键注意事项 #

• 将所有目标文件加入.gitignore，避免误提交，因为它们是自动生成的普通文件。
• 首次克隆仓库后，可手动运行post-checkout脚本一次，生成所有目标文件。
• 脚本可添加异常处理逻辑，比如源文件不存在时跳过，避免报错。

内容的提问来源于stack exchange，提问作者Bodenseematze