游戏客户端架构 / 系统课时
配置文件放 Git 还是资源仓库
配置文件放 Git 还是资源仓库
配置表一旦进入团队协作,就不能只看“哪里方便上传”。真正需要判断的是文件体积、修改频率、是否需要代码评审,以及配置与程序版本是否必须同步。选对存储位置后,策划修改、程序审查、版本回滚和构建发布才能形成稳定链路。
学习目标
- 根据体积、变更频率和审核需求判断配置是否适合进入 Git
- 区分配置源文件、生成文件和大型资源应该分别存放在哪里
- 建立配置与代码版本能够一起追踪和回滚的基本策略
先确认配置是不是代码版本的一部分
如果某份配置会直接改变当前客户端或服务器的运行行为,而且不同程序版本需要匹配不同配置版本,它实际上就是发布物的一部分。此时最重要的能力不是“大文件存储”,而是差异比较、评审、历史追踪和精确回滚,这些正是 Git 擅长的场景。
例如技能数值、道具参数、关卡规则、掉落权重等文本配置通常体积不大,却会频繁调整。把它们与代码放在同一仓库,或者放在独立 Git 配置仓库并明确版本依赖,都比只保留一份共享目录更容易审查变更。
可以先用 Git 验证配置是否能够正常作为文本文件追踪。下面的示例创建一个最小仓库并暂存一份 CSV 配置:
mkdir config-demo
cd config-demo
git init -q
printf 'itemId,name,price\n1001,Potion,50\n' > items.csv
git add items.csv
git status --short预期输出:
A items.csv这说明配置能够像代码一样进入变更集。真实项目中还应通过 Pull Request 或 Merge Request 查看差异,而不是直接覆盖线上文件。
用四个问题决定存储位置
不必根据文件扩展名机械判断,逐项检查下面四个条件更有效。
| 判断维度 | 更适合 Git | 更适合资源仓库 |
|---|---|---|
| 文件体积 | 小型文本、JSON、CSV、YAML 等 | 大型二进制、批量生成资源 |
| 变更方式 | 频繁小改,需要看差异 | 整体替换,文本差异价值低 |
| 协作方式 | 需要分支、评审、合并 | 主要按文件占用、上传下载协作 |
| 版本关系 | 必须和代码版本严格匹配 | 可以独立于代码生命周期管理 |
对于几十 KB 到数 MB 的文本配置,Git 通常没有问题。真正应避免的是把持续生成的大型二进制包、烘焙结果或大量无法有效比较的文件当成普通源码提交,否则仓库历史会不断膨胀。
源文件与生成物不要混在一起
团队里常见的一类问题是:策划维护 Excel,构建阶段再导出 JSON、二进制表或数据库文件。如果源文件和生成结果全部提交,修改一次可能产生大量重复变更,还容易出现“源文件已经更新,生成物忘记重新导出”的不一致。
更稳定的策略是明确唯一事实来源。例如团队决定 CSV 或在线表格导出的标准数据是源文件,那么运行时二进制可以在构建阶段重新生成;如果客户端必须直接读取 JSON,也可以把最终 JSON 纳入 Git,但应避免同时存在多个允许人工修改的等价版本。
需要长期保留的大型生成包、历史发布资源和美术资产,可以进入资源仓库或制品存储;Git 中只保存生成脚本、版本标识或必要的引用关系。
给团队一条可执行的边界
实际项目可以把规则收敛成一句话:小型、可比较、需要审核并且与程序版本绑定的配置优先进入 Git;大型二进制、可重新生成的重资源或独立生命周期资产进入资源仓库。
如果配置独立部署,还要额外记录“程序版本能够使用哪个配置版本”。否则即使两个仓库各自都有历史,发生线上问题时仍然无法快速重建当时的组合。存储位置只是第一步,最终目标始终是让一次配置修改能够被审查、定位、回滚并准确对应到发布版本。