Darktable导出失败需按顺序排查：先清缓存（rm -rf ~/.cache/darktable/或删Windows缓存文件夹），再验证目标路径权限与磁盘空间，接着启用-d imageio -d export调试定位故障点，然后重置导出设置并禁用Lua脚本及非核心插件，最后检查并重装图像编码库确保格式支持。
Darktable导出图片失败时，常表现为点击“导出”后无响应、进度条卡死、弹出空错误框或生成0字节文件，这类问题多由缓存冲突、路径权限不足、格式插件缺失或元数据写入中断引发，必须按顺序排查底层环节才能恢复导出功能。
检查并清除损坏的缓存文件
缓存目录损坏是导出失败最常见原因，尤其在非正常退出或磁盘满后，缩略图缓存与导出临时缓冲区可能残留不一致状态。
关闭darktable，打开终端（Linux/macOS）或命令提示符（Windows），执行以下操作：
Linux/macOS：运行 rm -rf ~/.cache/darktable/；Windows：进入 %LOCALAPPDATA%\darktable\cache\，手动删除整个 cache 文件夹。
【注意：此操作会清空所有缩略图，首次重启后需重新生成，但不会丢失任何编辑参数或图库数据】
重新启动darktable，尝试导出一张最小尺寸（如640×480）的JPEG测试图。若成功，说明缓存已修复；若仍失败，继续下一步。
验证导出目标路径权限与可用空间
darktable无法向只读目录、网络挂载点或剩余空间不足的分区写入文件，且不会明确提示“磁盘已满”或“拒绝访问”，仅静默失败。
第一步：在导出对话框中，将“目标位置”设为当前用户主目录下的一个新建子文件夹（如 ~/dt_test_export 或 C:\Users\用户名\dt_test_export）。
第二步：确保该文件夹存在且未被其他程序占用（例如Explorer窗口正打开该文件夹）。
第三步：右键该文件夹 → 属性 → 安全（Windows）或获取信息 → 共享与权限（macOS），确认当前用户拥有“写入”权限。
第四步：检查该磁盘剩余空间是否大于待导出图像原始大小的3倍（darktable导出过程需临时空间存放编码中间数据）。
启用调试模式定位具体失败环节
darktable内置调试子系统可输出导出流程每一步的执行状态，直接暴露崩溃点或阻塞源。
方法一（推荐）：终端中运行 darktable -d imageio -d export，然后在图形界面中触发一次导出操作，观察终端滚动日志。
方法二：若终端不可用，修改配置文件强制启用导出日志——编辑 ~/.config/darktable/darktable.conf（Windows为 %APPDATA%\darktable\darktable.conf），在末尾新增一行：plugins/imageio/format/jpeg/debug=1（若导出的是PNG则改为 png/debug=1）。
重启darktable后导出，失败时会在 ~/.cache/darktable/log/ 目录下生成带时间戳的 debug 日志文件，重点查找含 export failed、write error 或 NULL pointer 的行。
重置导出模块配置并禁用第三方插件
自定义样式、Lua导出钩子或第三方格式插件（如AVIF、WebP）可能与当前版本存在兼容性冲突，导致导出流程中断。
第一步：进入 编辑 > 偏好设置 > 导出，点击“恢复默认设置”按钮，清除所有自定义导出预设。
第二步：进入 编辑 > 偏好设置 > Lua脚本，取消勾选所有已启用的Lua脚本，尤其是涉及 export 或 imageio 关键字的脚本。
第三步：进入 编辑 > 偏好设置 > 插件，暂时禁用所有非核心插件（保留 jpeg、png、tiff 即可），然后重启软件。
此时使用默认JPEG格式导出测试图。若成功，说明原配置或某插件引发故障；可逐个启用插件/脚本，定位具体冲突项。
重建导出格式支持库
部分Linux发行版或手动编译版本缺少图像编码库链接，导致特定格式导出函数调用失败，但界面不报错。
① 检查系统是否安装基础编码库：Ubuntu/Debian运行 apt list --installed | grep -E "libjpeg|libpng|libtiff"；Fedora/RHEL运行 dnf list installed | grep -E "jpeg|png|tiff"。
② 若缺失，安装对应开发包：Ubuntu执行 sudo apt install libjpeg-dev libpng-dev libtiff-dev；Fedora执行 sudo dnf install libjpeg-devel libpng-devel libtiff-devel。
③ 若darktable为源码编译安装，需重新配置并编译：进入源码目录，执行 cmake -DENABLE_JPEG=ON -DENABLE_PNG=ON -DENABLE_TIFF=ON .，再运行 make && sudo make install。
④ 验证格式支持：启动darktable后，在导出对话框中切换格式下拉菜单，确认 JPEG、PNG、TIFF 选项可正常选择且无灰显。
