如何在PyQGIS插件中嵌入SVG符号（无需依赖外部SVG文件）

要实现把SVG符号嵌入到QGIS符号系统、不依赖外部文件的效果，核心思路是将SVG内容转换成Base64编码，再通过QGIS支持的data URI格式直接引用——这样SVG代码会被直接写入符号定义内部，无需额外文件依赖。下面是具体的实现步骤和代码示例：

核心原理 #

QGIS的QgsSvgMarkerSymbolLayer支持以data:image/svg+xml;base64,开头的路径格式，这种格式允许将SVG的Base64编码内容直接嵌入，替代传统的外部文件路径，从而实现符号的“内嵌”效果。

具体实现步骤 #

1. 准备原始SVG内容：编写或复制你的自定义SVG代码，注意用Python的三重引号包裹以避免转义问题，确保SVG语法正确（可先在本地编辑器测试显示效果）。
2. 编码为Base64字符串：使用Python的base64模块将SVG文本转换为Base64编码的字符串。
3. 创建内嵌路径的符号层：实例化QgsSvgMarkerSymbolLayer，将其path属性设置为拼接好的data URI格式字符串。
4. 组装符号并应用到图层：将符号层添加到标记符号中，再设置为目标矢量图层的渲染器。

完整代码示例 #

import base64
from qgis.core import (
    QgsVectorLayer,
    QgsSvgMarkerSymbolLayer,
    QgsMarkerSymbol,
    QgsSingleSymbolRenderer,
    QColor
)

# 1. 定义原始SVG内容（示例为一个带边框的绿色正方形）
svg_content = """
<svg width="20" height="20" viewBox="0 0 20 20" xmlns="http://www.w3.org/2000/svg">
    <rect x="2" y="2" width="16" height="16" fill="#00ff00" stroke="#000000" stroke-width="1.5"/>
</svg>
"""

# 2. 将SVG文本编码为Base64
svg_bytes = svg_content.encode('utf-8')
base64_encoded = base64.b64encode(svg_bytes).decode('utf-8')

# 3. 构建内嵌式SVG路径
embedded_svg_path = f"data:image/svg+xml;base64,{base64_encoded}"

# 4. 创建SVG标记符号层并配置属性
svg_symbol_layer = QgsSvgMarkerSymbolLayer()
svg_symbol_layer.setPath(embedded_svg_path)
svg_symbol_layer.setSize(6)  # 设置符号大小
# 若SVG使用了参数化颜色（如fill="param(fill)"），可动态修改颜色
# svg_symbol_layer.setFillColor(QColor("#ff0000"))

# 5. 组装符号并应用到目标图层
marker_symbol = QgsMarkerSymbol()
marker_symbol.changeSymbolLayer(0, svg_symbol_layer)  # 替换默认符号层

# 获取目标图层（替换为你的图层名称）
target_layer = QgsProject.instance().mapLayersByName("你的矢量图层")[0]
# 设置渲染器
renderer = QgsSingleSymbolRenderer(marker_symbol)
target_layer.setRenderer(renderer)

# 触发图层重绘，更新显示
target_layer.triggerRepaint()

注意事项 #

• 确保SVG语法正确，若存在语法错误，QGIS会无法解析并显示默认占位符。
• 若需要动态修改符号颜色，建议在SVG代码中使用参数化属性（如fill="param(fill)"），而非硬编码颜色值，这样可以通过setFillColor()等方法直接修改。
• 避免使用过大的SVG内容，虽然Base64编码不影响功能，但过大的内容会增加符号定义体积，可能影响图层加载效率。
• 可通过在线Base64解码工具验证编码后的内容是否能还原为原始SVG，排查编码错误问题。

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