如何将PostgreSQL数据提交至Git？Docker Compose场景优化

方案一：用单份SQL备份文件替代原生数据目录存储 #

PostgreSQL的原生数据目录结构天生会生成大量细分文件，无法直接改成单文件存储模式。针对数据量小的场景，更实用的方式是用SQL备份文件来管理数据：

1. 生成单份备份文件：每次修改数据库后，执行以下命令导出全量数据到单个SQL文件：

   docker exec aimd-postgres pg_dump -U postgres postgres > ./database/backup.sql
   

2. 修改Docker Compose配置：启动容器时自动从备份文件恢复数据，无需挂载原生数据目录：

   services:
     postgres:
       container_name: aimd-postgres
       environment:
         POSTGRES_PASSWORD: postgres
         POSTGRES_USER: postgres
       image: postgres:16
       ports:
         - '65432:5432'
       volumes:
         - ./database/backup.sql:/docker-entrypoint-initdb.d/backup.sql
   

   这样Git只需要跟踪backup.sql这一个文件，完全解决多文件提交的问题，同时备份文件的兼容性也比原生数据文件更好。

方案二：让Git批量处理数据目录文件 #

如果坚持要直接提交原生数据目录，可以通过以下方式让Git把目录当作整体处理：

1. 一次性提交整个目录：无需逐个指定文件，直接执行命令添加目录下所有修改：

   git add ./database/
   git commit -m "更新数据库数据文件"
   

   Git会自动把目录下所有新增/修改的文件纳入提交，不需要手动逐个选择。
2. 优化Git显示效果：在项目根目录创建.gitattributes文件，添加以下内容：

   database/** binary
   

   这会让Git将database目录下的所有文件识别为二进制文件，提交时不会显示繁琐的文本差异，只展示目录整体的变更记录，让提交记录更整洁。

注意：直接提交PostgreSQL原生数据目录存在版本兼容性风险，不同PostgreSQL版本的data文件格式可能不兼容，建议优先选择方案一。

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