QGIS项目中图层复制功能的自定义属性传递问题分析

问题背景

在QGIS项目中，当用户使用"Duplicate Layer"(复制图层)功能时，发现通过图层树界面设置的自定义属性没有被正确复制到新图层中。这是一个影响用户体验的功能性问题，特别是在依赖自定义属性进行工作流管理的场景下。

技术分析

QGIS中存在两种自定义属性存储机制：

1. 通过QgsProject.instance().mapLayers()接口设置的自定义属性
2. 通过QgsProject.instance().layerTreeRoot()接口设置的自定义属性

经过深入代码分析，发现问题的根源在于图层复制功能的实现逻辑：

1. 正确行为的复制/粘贴流程：

• 使用QgisApp::copyLayer()方法
• 使用QgisApp::pasteLayer()方法 这两个方法会完整保留所有自定义属性

2. 存在问题的复制图层流程：

• 使用QgisApp::duplicateLayers()方法
• 该方法仅通过QgsMapLayer::clone()复制了QgsMapLayer的自定义属性
• 但忽略了关联的QgsLayerTreeLayer的自定义属性

解决方案

问题的解决方案是在复制图层后，手动将图层树节点的自定义属性复制到新创建的图层树节点中。具体实现是在创建新图层树节点后，添加以下代码逻辑：

// 复制图层树节点的自定义属性
for (const QString &key : nodeSelectedLyr->customProperties()) {
    nodeDupLayer->setCustomProperty(key, nodeSelectedLyr->customProperty(key));
}

这个修改确保了无论是通过哪种接口设置的自定义属性，都能在复制图层时被完整保留。

技术影响

这个修复对QGIS项目具有重要意义：

1. 保证了功能一致性，使复制图层和复制/粘贴操作的行为统一
2. 解决了依赖自定义属性工作流的插件(如Layer Color Plugin)的兼容性问题
3. 提升了用户体验，避免了因属性丢失导致的工作中断

实现验证

该解决方案已经过实际测试验证：

1. 在QGIS 3.22.4和3.43.0-Master版本上均测试通过
2. 验证了各种类型图层(矢量、点云、栅格等)的自定义属性传递
3. 确认了解决方案不会引入新的副作用

总结

这个问题的解决展示了QGIS项目中图层管理机制的复杂性，也体现了开源社区通过代码审查和问题跟踪来持续改进软件的协作模式。对于开发者而言，理解QGIS中图层和图层树节点的双重属性存储机制，对于开发稳定可靠的插件和自定义功能至关重要。