游戏客户端架构 / 系统课时

配置文件放 Git 还是资源仓库

配置文件放 Git 还是资源仓库

配置表一旦进入团队协作,就不能只看“哪里方便上传”。真正需要判断的是文件体积、修改频率、是否需要代码评审,以及配置与程序版本是否必须同步。选对存储位置后,策划修改、程序审查、版本回滚和构建发布才能形成稳定链路。

学习目标

  • 根据体积、变更频率和审核需求判断配置是否适合进入 Git
  • 区分配置源文件、生成文件和大型资源应该分别存放在哪里
  • 建立配置与代码版本能够一起追踪和回滚的基本策略

先确认配置是不是代码版本的一部分

如果某份配置会直接改变当前客户端或服务器的运行行为,而且不同程序版本需要匹配不同配置版本,它实际上就是发布物的一部分。此时最重要的能力不是“大文件存储”,而是差异比较、评审、历史追踪和精确回滚,这些正是 Git 擅长的场景。

例如技能数值、道具参数、关卡规则、掉落权重等文本配置通常体积不大,却会频繁调整。把它们与代码放在同一仓库,或者放在独立 Git 配置仓库并明确版本依赖,都比只保留一份共享目录更容易审查变更。

可以先用 Git 验证配置是否能够正常作为文本文件追踪。下面的示例创建一个最小仓库并暂存一份 CSV 配置:

bash
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

预期输出:

text
A  items.csv

这说明配置能够像代码一样进入变更集。真实项目中还应通过 Pull Request 或 Merge Request 查看差异,而不是直接覆盖线上文件。

用四个问题决定存储位置

不必根据文件扩展名机械判断,逐项检查下面四个条件更有效。

判断维度 更适合 Git 更适合资源仓库
文件体积 小型文本、JSON、CSV、YAML 等 大型二进制、批量生成资源
变更方式 频繁小改,需要看差异 整体替换,文本差异价值低
协作方式 需要分支、评审、合并 主要按文件占用、上传下载协作
版本关系 必须和代码版本严格匹配 可以独立于代码生命周期管理

对于几十 KB 到数 MB 的文本配置,Git 通常没有问题。真正应避免的是把持续生成的大型二进制包、烘焙结果或大量无法有效比较的文件当成普通源码提交,否则仓库历史会不断膨胀。

源文件与生成物不要混在一起

团队里常见的一类问题是:策划维护 Excel,构建阶段再导出 JSON、二进制表或数据库文件。如果源文件和生成结果全部提交,修改一次可能产生大量重复变更,还容易出现“源文件已经更新,生成物忘记重新导出”的不一致。

更稳定的策略是明确唯一事实来源。例如团队决定 CSV 或在线表格导出的标准数据是源文件,那么运行时二进制可以在构建阶段重新生成;如果客户端必须直接读取 JSON,也可以把最终 JSON 纳入 Git,但应避免同时存在多个允许人工修改的等价版本。

需要长期保留的大型生成包、历史发布资源和美术资产,可以进入资源仓库或制品存储;Git 中只保存生成脚本、版本标识或必要的引用关系。

给团队一条可执行的边界

实际项目可以把规则收敛成一句话:小型、可比较、需要审核并且与程序版本绑定的配置优先进入 Git;大型二进制、可重新生成的重资源或独立生命周期资产进入资源仓库。

如果配置独立部署,还要额外记录“程序版本能够使用哪个配置版本”。否则即使两个仓库各自都有历史,发生线上问题时仍然无法快速重建当时的组合。存储位置只是第一步,最终目标始终是让一次配置修改能够被审查、定位、回滚并准确对应到发布版本。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置文件放 Git 还是资源仓库

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通