darktable提供五种畸变校正方法：一、lensfun自动校正；二、嵌入式元数据修复；三、手动参数调整；四、多实例组合校正；五、基础变换模块辅助矫正如透视失真。
一、启用Lensfun自动畸变校正
darktable通过Lensfun开源数据库匹配相机与镜头型号，读取预存的几何畸变参数，实现桶形与枕形畸变的自动补偿。该方法依赖EXIF中记录的焦距、光圈和镜头型号信息，无需人工干预即可启动高精度校正。
1、在暗房（Darkroom）模式下打开待处理的RAW或JPEG图像。
2、于右侧模块面板中定位「镜头校正」模块（图标为?），点击展开。
3、勾选「启用镜头校正」复选框。
4、在「校正方法」下拉菜单中选择「Lensfun数据库」。
5、确保「校正标志」中已勾选「畸变」选项（对应位掩码DT_IOP_LENS_MODIFY_FLAG_DISTORTION）。
6、点击右上角「更新镜头数据库」按钮（若此前未更新），等待进度完成并提示“数据库已就绪”。
二、基于嵌入式元数据的畸变修复
部分现代相机（如Leica Q系列、Sony ILCE机型）在拍摄时将厂商定制的畸变校正参数直接写入RAW文件的OpcodeList标签中。darktable可原生解析这些指令，执行与机内处理一致的像素级几何映射，避免二次插值损失。
1、确认图像EXIF中存在OpcodeList1/2/3字段（可通过右键图像→「元数据」→「显示完整EXIF」验证）。
2、在「镜头校正」模块中，将「校正方法」设为「嵌入式元数据」。
3、取消勾选「Lensfun数据库」及「仅手动暗角」选项，防止冲突覆盖。
4、观察预览区域是否立即出现畸变改善；若无响应，检查图像是否来自支持该特性的机型。
5、启用「缩放」滑块微调输出尺寸，补偿校正后边缘裁剪导致的构图变化。
三、手动畸变参数精细调整
当自动方法无法完全消除残留弯曲（如复杂胡子畸变或老旧镜头无数据库条目），需进入手动模式，直接操控畸变校正强度与空间分布。该方式绕过镜头识别，适用于任意图像，但需视觉反馈辅助判断。
1、在「镜头校正」模块中，将「校正方法」切换为「仅手动暗角」。
2、向下滚动至「畸变校正」区域，取消勾选「启用镜头校正」以隔离控制权。
3、拖动「cor_dist_ft」滑块：数值为0表示无校正；正值（0.1–1.5）校正桶形畸变；负值（–0.1至–1.0）校正枕形畸变。
4、同步调节「scale」参数（建议范围0.95–1.05），补偿因畸变拉伸/压缩造成的画面缩放失衡。
5、启用「inverse」开关可反转校正方向，用于创意扭曲效果而非修复。
四、组合多实例畸变校正
针对严重胡子畸变（中心桶形+边缘枕形混合），单一cor_dist_ft参数无法线性拟合全画幅非均匀形变。此时可叠加两个独立的镜头校正模块实例，分别控制不同空间频段的畸变分量，提升拟合精度。
1、右键「镜头校正」模块标题栏，选择「添加新实例」。
2、第一个实例配置为Lensfun自动校正，专注中低频整体弯曲（保持默认参数）。
3、第二个实例设置为手动模式，关闭「畸变」标志，仅启用「色差」与「暗角」校正，避免重复运算。
4、在第二个实例中，启用「高级」选项卡，将「cor_dist_ft」设为小幅度反向值（如+0.08或–0.06）。
5、反复切换两个实例的启用/禁用状态，比对边缘直线（如建筑窗框、地平线）的残余弯曲程度。
6、最终保留启用状态的两个实例，并在历史记录中命名其作用（例：“主畸变校正”、“边缘微调”）。
五、使用基础变换模块辅助矫正
当畸变伴随明显透视倾斜（如仰拍高楼导致线条汇聚），单纯镜头校正无法恢复平行关系。此时应结合「旋转与透视」模块进行几何约束，先稳定结构再优化光学形变，形成分层修复流程。
1、在模块面板顶部找到「旋转与透视」模块，确保其位于「镜头校正」模块之前（顺序影响渲染管线）。
2、启用「网格叠加」，拖动四角控制点使垂直/水平参考线与图像中真实直线对齐。
3、调节「垂直透视」与「水平透视」滑块，消除因拍摄角度导致的梯形失真。
4、完成透视校正后，再启用「镜头校正」模块处理残余的纯光学畸变。
5、最后使用「缩放」滑块统一补偿两次几何变换引起的画面缩小，务必在所有几何操作完成后执行此步，否则会放大插值伪影。
