数据库文档在依赖人为纪律时会失败
发布: (2026年2月24日 GMT+8 08:16)
2 分钟阅读
原文: Dev.to
Source: Dev.to
Problem
理论上,数据库文档很简单。
但在实际项目中,这种情况很少能维持。模式变化迅速,需求会变,热修复也会出现。并不是因为团队不在乎,而是手动同步根本无法扩展。到了一定程度,ER 图不再是事实的来源,而变成了过去的快照。
Solution
对我而言,更好的做法是彻底改变模型:不再手动维护文档,而是从实际模型生成文档,并与项目一起进行版本控制,就像代码一样。这个想法最终演变成 ForgeSQL——一个可视化建模工具,图表不再是附属品,而是生成以下内容的源头:
- 真正的 SQL
- 真正的 Docker 环境
- 在 GitHub 中进行版本管理的制品
不再需要“保持更新”的图表。只需一个始终与现实保持一致的模型。
Discussion
我很好奇其他团队今天是如何处理这个问题的:到底有什么真正保证你的数据库图仍然能够反映生产环境?