如何通过PyQGIS导出带透明背景的无边距PNG栅格图层

以下是对应你GUI操作流程的Python实现代码，解决图层适配和透明背景的问题：

完整代码实现 #

from qgis.core import (QgsProject, QgsPrintLayout, QgsLayoutItemMap,
                       QgsLayoutExporter, QgsLayoutSize, QgsUnitTypes)
from qgis.PyQt.QtCore import QRectF

# 配置参数
TARGET_LAYER_NAME = "你的目标栅格图层名称"
EXPORT_PATH = "C:/输出路径/透明无空白导出.png"

# 1. 隐藏非目标图层
project = QgsProject.instance()
for layer in project.mapLayers().values():
    layer.setVisible(layer.name() == TARGET_LAYER_NAME)

# 2. 创建打印布局并添加地图项
canvas = iface.mapCanvas()
layout = QgsPrintLayout(project)
layout.initializeDefaults()

map_item = QgsLayoutItemMap(layout)
layout.addLayoutItem(map_item)

# 3. 匹配地图项与栅格图层范围
target_layer = project.mapLayersByName(TARGET_LAYER_NAME)[0]
map_item.setExtent(target_layer.extent())

# 4. 设置透明背景
# 关闭地图项背景填充
map_item.setBackgroundEnabled(False)
# 移除页面背景样式
page = layout.pageCollection().pages()[0]
page.setPageStyleSymbol(None)

# 5. 适配页面尺寸与地图范围
# 设置页面边距为0
layout.pageCollection().setPageMargins(0, 0, 0, 0)
# 调整地图项填满页面，再让页面匹配地图项尺寸
map_item.attemptResize(QRectF(0, 0, page.pageSize().width(), page.pageSize().height()))
layout.setPageSize(QgsLayoutSize(map_item.rect().width(), map_item.rect().height(), QgsUnitTypes.LayoutMillimeters))

# 6. 导出PNG（开启透明背景）
exporter = QgsLayoutExporter(layout)
export_settings = QgsLayoutExporter.ImageExportSettings()
export_settings.transparentBackground = True
exporter.exportToImage(EXPORT_PATH, export_settings)

关键注意点 #

• 图层范围匹配：确保map_item.setExtent(target_layer.extent())正确获取栅格的完整范围，若范围有误，可打印target_layer.extent()验证。
• 透明背景生效：必须同时关闭地图项背景、移除页面背景样式，且导出时开启transparentBackground参数。
• 页面适配：先让地图项填满初始页面，再调整页面尺寸匹配地图项，对应GUI中"调整布局以适配内容"的逻辑。

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