在GitHub仅追踪特定文件：游戏Mod版本控制方案问询

针对你需要本地保留完整游戏项目、仅向GitHub上传修改/指定文件的需求，以下是几种比手动维护.gitignore更高效的方案：

方案1：Git稀疏检出（Sparse Checkout）反向配置 #

这是当前最贴合需求的原生Git方案，无需额外工具，能精准控制远程仓库的文件范围：

1. 先在GitHub创建一个空的远程仓库
2. 本地游戏目录初始化Git仓库并关联远程：

   git init
   git remote add origin <你的GitHub仓库地址>
   

3. 启用稀疏检出功能：

   git config core.sparseCheckout true
   

4. 编辑.git/info/sparse-checkout文件，只写入你需要上传的文件或目录路径（每行一个），比如：

   Mods/MyCustomMod/
   GameData/ModifiedConfig.ini
   Scripts/MyPatch.lua
   

5. 更新本地索引并提交：

   git add .
   git commit -m "Initial mod files"
   git push origin main
   

• 优势：本地完整保留游戏目录，Git仅追踪你指定的文件，其他文件自动被忽略；无需手动维护.gitignore，后续新增需要上传的文件只需添加到sparse-checkout即可。
• 注意：如果后续修改了未在sparse-checkout中的文件，Git不会追踪，完全符合你的需求。

方案2：拆分独立Mod仓库（嵌套Git结构） #

如果你的Mod文件集中在特定目录，可以把该目录单独作为Git仓库：

1. 在游戏目录中找到你的Mod专属文件夹（比如./MyMod），进入该目录初始化Git并关联远程：

   cd MyMod
   git init
   git remote add origin <你的GitHub仓库地址>
   

2. 正常提交、推送该目录下的文件即可，游戏其他目录无需纳入Git管理。

• 优势：结构清晰，完全隔离游戏文件和Mod文件；本地依然可以完整访问整个游戏目录，仅Mod目录同步到GitHub。
• 注意：如果你的Mod文件分散在多个游戏子目录，这种方案需要把所有涉及的文件软链接到同一个Mod目录，再管理这个目录的Git。

方案3：自动筛选修改文件的脚本 #

利用Git命令自动识别修改过的文件，批量提交推送，避免手动选择：

1. 编写一个简单的Shell脚本（比如push-mod.sh）：

   #!/bin/bash
   # 获取所有已暂存的修改文件
   MODIFIED_FILES=$(git diff --name-only --cached)
   if [ -z "$MODIFIED_FILES" ]; then
       echo "No modified files to push"
       exit 0
   fi
   # 提交并推送
   git commit -m "Update mod files"
   git push origin main
   

2. 给脚本添加执行权限：chmod +x push-mod.sh
3. 日常开发时，先手动确认要提交的文件（git add <指定文件>），然后运行脚本完成推送。

• 优势：无需配置复杂规则，适合文件分散但修改频率不高的场景；完全由你控制提交的文件范围。

避坑提醒 #

• 不要使用git update-index --assume-unchanged：该命令标记文件为“未修改”，如果后续游戏更新覆盖了这些文件，Git会完全忽略，容易丢失你的Mod修改。
• 稀疏检出模式下，若需要新增上传文件，直接追加到.git/info/sparse-checkout后执行git add .即可，Git会自动追踪新添加的路径。

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