基于PyQGIS为图层组生成地图主题的代码问题排查

我基于GIS社区相关内容编写了两段PyQGIS代码，目标是为项目中的每个图层组生成对应的地图主题，但两段代码均无法正常运行。想请教哪段代码具备可行解决方案的潜力？其中的错误点在哪里？（个人更倾向于代码2）

代码1 #

root = QgsProject.instance().layerTreeRoot()
groups = root.findGroups()

for group in groups:
       group.setItemVisibilityChecked(True)
       layersToChanges = group.findLayers()
       for layer in layersToChanges:
    for child in root.children():
        if isinstance(child, QgsLayerTreeGroup):
            print("- group: " + child.name())
        elif isinstance(child, QgsLayerTreeLayer):
            print("- layer: " + child.name() + "  ID: " + child.layerId())
            # Layer you want to tick
            if (child.name() == layer):
                child.setItemVisibilityChecked(True)
                print("Check only once")
            elif child.name() in layersToChanges:
                child.setItemVisibilityChecked(False)
                print("Check the others you want to hide")
    mapThemeRecord = QgsMapThemeCollection.createThemeFromCurrentState(
        QgsProject.instance().layerTreeRoot(),
        iface.layerTreeView().layerTreeModel()
    )
    mapThemesCollection.insert(layer, mapThemeRecord)

代码1的错误点 #

• 语法缩进错误：内层for child in root.children()循环缩进混乱，直接导致代码无法运行。
• 变量未定义：mapThemesCollection变量未初始化就调用insert方法，会触发报错。
• 逻辑匹配错误：child.name() == layer中，layer是QgsLayerTreeLayer对象，不是字符串，永远无法匹配；child.name() in layersToChanges同理，layersToChanges是图层对象列表，不是名称字符串列表，判断无效。
• 循环逻辑冗余混乱：遍历组内图层后又重复遍历整个根节点子元素，无法精准控制图层可见性来生成目标主题。

代码2（编辑后） #

#Variables: Groups, project layer
root = QgsProject.instance().layerTreeRoot()
groups = root.findGroups()
AllLayers = root.findLayers()

#Visibilities
for layer in AllLayers:
    layer.setItemVisibilityChecked(False)
for group in groups:
    group.setItemVisibilityChecked(False)

for group in groups:
    group.setItemVisibilityChecked(True)
    groupLayers = group.findLayers()
    for groupLayer in groupLayers:
        groupLayer.setItemVisibilityChecked(True)

#Set themes for each group
    mtc = QgsProject.instance().mapThemeCollection()
    theme_name = str(group)
    theme_state = mtc.mapThemeState(theme_name)
    layer_record = QgsMapThemeCollection.MapThemeLayerRecord()
    theme_state.addLayerRecord(layer_record)
    group.setItemVisibilityChecked(False)

代码2的错误点 #

• 缩进错误：#Set themes for each group下的代码块缩进错误，未正确嵌套在for group in groups循环内，会触发语法报错。
• 主题名称错误：theme_name = str(group)会将图层组对象转为类似<QgsLayerTreeGroup: 组名>的字符串，不是直接获取组名，应该用group.name()。
• 主题状态逻辑错误：mtc.mapThemeState(theme_name)是获取已存在的主题状态，若主题不存在则返回空状态；且手动创建的layer_record未关联任何图层，完全无效。
• 缺少主题插入步骤：仅创建了theme_state但未将其插入到地图主题集合中，无法完成主题保存。

代码2的潜力 #

代码2的核心逻辑是先隐藏所有图层和组，再逐个显示目标组及其图层，基于当前可见状态生成主题，这个思路完全符合地图主题生成的常规流程，只要修正上述错误就能正常运行，具备明显的可行潜力。

代码2的修正示例 #

# 获取项目图层树根节点
root = QgsProject.instance().layerTreeRoot()
groups = root.findGroups()
all_layers = root.findLayers()

# 先隐藏所有图层和组
for layer in all_layers:
    layer.setItemVisibilityChecked(False)
for group in groups:
    group.setItemVisibilityChecked(False)

# 获取地图主题集合
mtc = QgsProject.instance().mapThemeCollection()

for group in groups:
    # 显示当前组及其下所有图层
    group.setItemVisibilityChecked(True)
    for layer in group.findLayers():
        layer.setItemVisibilityChecked(True)
    
    # 基于当前可见状态创建主题记录
    theme_name = group.name()
    theme_record = QgsMapThemeCollection.createThemeFromCurrentState(
        root, iface.layerTreeView().layerTreeModel()
    )
    # 插入或更新主题到集合
    mtc.insert(theme_name, theme_record)
    
    # 隐藏当前组，准备下一个循环
    group.setItemVisibilityChecked(False)

内容的提问来源于stack exchange，提问作者A J