Flask-AppBuilder跨Github与VS Code同步时app.db未更新问题咨询

• 所有Flask-AppBuilder初始化生成的项目模板，默认会在.gitignore规则中加入*.db、instance/等路径匹配规则，目的是防止包含用户凭据、运行时敏感数据的数据库文件被误提交到代码仓库，这是Python Web项目的通用安全默认配置，也是app.db无法被git追踪同步的核心原因。
• Replit平台的自动同步功能默认仅同步代码类文件，运行时生成的二进制数据文件（包括SQLite数据库文件）不会被自动加入提交队列，必须手动操作git才能完成推送。
• 部分Replit预置的Flask模板会将SQLite数据库存放在平台专属的持久化存储目录，项目根目录下的app.db只是指向该路径的软链接，就算你手动add也无法把实际数据提交到仓库。
• 本地VSCode环境如果在拉取代码时正运行着Flask服务，app.db会被SQLite引擎锁定，就算远端仓库更新了该文件，本地也会拉取失败，保留旧版本数据。

1. 调整git忽略规则
   打开项目根目录下的.gitignore文件，删除所有匹配*.db、app.db、instance/的规则行。

风险提示：如果你的代码仓库是公开状态，直接提交存储用户密码哈希的数据库文件会造成敏感信息泄露，仅个人测试场景可使用该方案，正式项目严禁直接提交数据库文件。

2. 确认数据库文件为实体文件
   在Replit的Shell终端进入项目根目录，执行命令检查文件属性：

ls -l app.db

如果返回结果的权限位首字符为l，说明当前是软链接。先找到数据库实际存储路径，将实体文件复制到项目根目录，再修改项目配置中SQLALCHEMY_DATABASE_URI的值为sqlite:///app.db，重启服务确认数据正常后再进行后续操作。

3. 手动提交推送数据库文件
   不要依赖Replit的自动同步功能，在终端直接执行git命令完成提交：

git add app.db
git commit -m "sync: update app.db with latest user data"
git push  # 如果分支不是main，补充对应远端分支名

4. 本地拉取同步
   先关闭本地VSCode中正在运行的Flask-AppBuilder服务，释放app.db的文件锁，再执行git pull拉取最新代码，重启服务后即可看到同步的用户账号数据。

如果不想直接提交数据库文件，可以用Flask-AppBuilder自带的数据导出导入能力同步用户数据，避免二进制文件冲突和敏感信息泄露：

• 在Replit环境新增用户后，执行导出命令生成数据fixture文件：

flask fab dump-data User > user_fixtures.json

• 将user_fixtures.json提交到git仓库，所有环境拉取代码后执行导入命令即可生成一致的用户数据：

flask fab load-data user_fixtures.json

该方案同步的是结构化文本数据，不会出现二进制文件锁、合并冲突问题，也符合代码仓库的版本管理最佳实践。

内容的提问来源于stack exchange，提问作者PROGETTAZIONE STUDIO GB