PyQGIS设置字段ValueMap控件后导出GPKG失效问题

问题根源 #

GeoPackage是OGC标准的空间数据格式，仅存储图层的几何数据、属性字段结构和属性值，不支持保存QGIS特有的编辑器控件配置（比如ValueMap这类UI层面的设置）。你通过setEditorWidgetSetup设置的控件类型，只是当前QGIS会话中图层的临时配置，不会被写入GeoPackage文件本身，因此重新导入后会恢复默认的TextEdit控件。

解决方法 #

方法1：保存QGIS项目文件 #

将配置好控件的图层添加到QGIS项目中，直接保存项目（.qgz/.qgs格式）。下次打开该项目时，图层的编辑器控件设置会自动加载，无需重复配置。

方法2：将控件配置写入GeoPackage图层样式（推荐） #

QGIS支持将图层样式（包括编辑器控件设置）保存到GeoPackage的layer_styles表中，实现导入时自动加载配置。修改代码如下：

# 原有字段定义
fields = [QgsField("name", QVariant.String),QgsField("code", QVariant.String),QgsField("email", QVariant.String)]
# 假设已完成图层创建与初始化（layer变量已存在）

# 设置code字段的ValueMap控件
code_field_index = layer.fields().indexFromName("code")
widget_setup = QgsEditorWidgetSetup('ValueMap', {'Map': {'1': 'Option 1', '2': 'Option 2', '3': 'Option 3'}})
layer.setEditorWidgetSetup(code_field_index, widget_setup)

# 创建并保存图层样式到GeoPackage
style_manager = layer.styleManager()
style_manager.addStyle("default_style", layer.style())
# 将样式写入GeoPackage的layer_styles表
layer.saveStyleToDatabase("default_style", "包含ValueMap控件的样式", True, "")

# 使用新版API导出图层并同步保存样式
export_path = "path/to/your_geopackage.gpkg"
options = QgsVectorFileWriter.SaveVectorOptions()
options.driverName = "GPKG"
options.encoding = "UTF-8"
options.saveStyle = True  # 关键参数：导出时同步保存样式配置
QgsVectorFileWriter.writeAsVectorFormatV2(layer, export_path, QgsProject.instance().transformContext(), options)

导出完成后，将GeoPackage拖入QGIS时：

• 右键图层 → 「样式」→「加载样式」→「从数据库加载」，选择保存的default_style即可恢复ValueMap控件；
• 部分QGIS版本支持导入时直接勾选「加载样式」选项，可自动应用配置。

内容的提问来源于stack exchange，提问作者Bendigo McAllan