如何在Git主项目中为多子模块创建跨文件夹文件符号链接？

完全可以通过Git本身的符号链接支持实现需求，不管是单个子模块还是多个子模块，都能搞定，下面是具体方法：

一、手动创建单个子模块的符号链接 #

Git默认支持追踪符号链接（前提是操作系统支持，Linux/macOS原生支持，Windows需开启开发者模式），步骤如下：

1. 在RepoA的根目录下，直接用系统命令创建相对路径的符号链接。比如要把RepoB里的file1链接到folder1：

   ln -s ../RepoB/file1 folder1/file1
   

2. 将创建好的符号链接提交到RepoA：

   git add folder1/file1
   git commit -m "Add symlink to RepoB/file1 in folder1"
   

Git会把符号链接当作特殊文件存储（仅保存路径文本，不是文件内容），其他成员克隆RepoA并初始化子模块后，符号链接会自动指向子模块内的对应文件。

二、批量处理多子模块的脚本方案 #

如果有多个子模块需要配置大量符号链接，手动操作太繁琐，不妨写个脚本批量生成：

1. 先创建一个配置文件link_config.txt，每行定义一组子模块、目标文件夹和要链接的文件，格式如下：

   RepoB folder1 file1 file2
   RepoC folder2 doc1 doc2
   RepoD folder3 img1 img2
   

2. 编写Shell脚本create_symlinks.sh读取配置文件并创建符号链接：

   #!/bin/bash
   # 读取配置文件批量创建符号链接
   while read -r submodule target_folder files; do
       # 确保目标文件夹存在
       mkdir -p "$target_folder"
       # 遍历要链接的文件
       for file in $files; do
           link_path="$target_folder/$file"
           # 如果已有同名符号链接，先删除
           if [ -L "$link_path" ]; then
               rm "$link_path"
           fi
           # 创建相对路径的符号链接
           ln -s "../../$submodule/$file" "$link_path"
           echo "已创建符号链接: $link_path -> $submodule/$file"
       done
   done < link_config.txt
   

3. 给脚本添加执行权限并运行：

   chmod +x create_symlinks.sh
   ./create_symlinks.sh
   

4. 把link_config.txt和脚本一起提交到RepoA，方便团队成员复用，后续更新链接配置只需要修改配置文件再运行脚本即可。

三、关键注意事项 #

• 子模块必须先初始化：克隆RepoA后，必须执行git submodule init和git submodule update拉取所有子模块的代码，否则符号链接会指向不存在的文件。
• 使用相对路径：绝对路径会导致克隆到不同目录时符号链接失效，一定要用相对路径（比如示例中的../RepoB/file1）。
• 跨平台兼容：Windows系统需要开启开发者模式才能创建符号链接，或者把脚本中的ln -s替换为Windows的mklink命令（文件用mklink，文件夹用mklink /D），也可以在脚本中加入平台判断逻辑自动适配。

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