darktable数据丢失后需立即执行备份恢复：一、启用自动版本升级备份；二、手动全量备份配置；三、恢复library.db主库；四、单独恢复xmp侧车文件；五、跨设备同步styles目录。
如果您使用darktable管理大量照片并积累了丰富的编辑历史与预设，但突然遭遇数据库损坏、版本升级失败或误删配置，导致图像元数据、历史栈、样式和收藏状态丢失，则需立即执行可靠的备份恢复操作。以下是针对darktable核心数据的多种备份与恢复方法：
一、启用并验证自动版本升级备份
darktable在检测到SQLite数据库结构变更（如从5.2.0升级至5.4.0）时，会自动创建带版本标识的只读备份文件，防止升级失败导致数据不可逆损坏。该机制依赖于配置目录下library.db文件的变更触发。
1、打开终端，进入darktable配置目录：cd ~/.config/darktable
2、列出所有以library.db-pre-开头的备份文件：ls -la library.db-pre-*
3、确认最新备份文件的时间戳与目标版本号是否匹配，例如library.db-pre-5.4.0表示升级前5.4.0版本的完整快照。
二、执行手动全量配置备份
自动备份仅覆盖library.db，不包含data.db（存储插件设置与界面布局）、darktablerc（全局参数）及styles/目录（用户自定义样式）。手动全量备份可确保全部个性化配置可完整还原。
1、创建带时间戳的备份目录：mkdir -p ~/darktable_backups/$(date +%Y%m%d_%H%M%S)
2、复制核心数据库与配置文件：cp library.db data.db darktablerc ~/darktable_backups/$(date +%Y%m%d_%H%M%S)/
3、压缩样式目录：tar -czf ~/darktable_backups/$(date +%Y%m%d_%H%M%S)/styles.tar.gz styles/
4、生成备份清单：echo "备份时间: $(date)" > ~/darktable_backups/$(date +%Y%m%d_%H%M%S)/backup.info
三、恢复受损的library.db主数据库
当darktable启动报错“database is locked”或无法加载历史栈时，可将最近一次有效的library.db-pre-*备份文件还原为当前主库，跳过损坏状态直接回退。
1、停止所有darktable进程：pkill -f darktable
2、重命名当前损坏的库文件：mv library.db library.db.corrupted
3、选择一个可用备份（例如library.db-pre-5.4.0），复制为新主库：cp library.db-pre-5.4.0 library.db
4、设置正确权限：chmod 600 library.db
四、单独恢复XMP侧车文件以找回CR2等原始图像编辑历史
darktable将每张图像的调整步骤写入同名.xmp文件，该文件独立于library.db存在。若数据库恢复后历史栈为空，但原始目录中仍存有.xmp文件，则可强制重新加载。
1、在文件浏览器中定位某张CR2图像所在目录，确认存在同名.xmp文件（如IMG_0001.CR2对应IMG_0001.xmp）
2、在darktable中进入“暗房”模式，点击右侧面板“历史”选项卡
3、点击“重新加载XMP侧车文件”按钮（图标为两个箭头循环）
4、等待进度条完成，检查历史栈是否显示完整操作序列
五、跨设备迁移时同步styles与预设
styles/目录存放相机特定配置、色彩映射模板与用户创建的样式，其路径硬编码在library.db中。若更换电脑或重装系统，仅复制library.db会导致样式路径失效，必须同步该目录。
1、将旧系统中的styles/目录完整复制到新系统的对应位置：cp -r ~/.local/share/darktable/styles/ ~/.local/share/darktable/
2、确保新系统中该路径拥有读写权限：chmod -R u+rw ~/.local/share/darktable/styles/
3、启动darktable，在“光谱”或“色调曲线”模块中验证自定义样式是否出现在下拉列表
