QWebEngineView无法显示本地图片问题求助

问题原因 #

使用setHtml()加载HTML字符串时，QWebEngineView默认没有关联本地文件的上下文，无法正确解析本地绝对路径的图片。Chrome浏览器打开本地HTML时会自动处理本地路径的上下文，但Qt的WebEngine组件需要明确指定本地文件的访问规则。

解决方法 #

方法1：设置setHtml()的baseUrl参数

将图片所在的本地目录转换为QUrl对象，作为baseUrl传入setHtml()，这样HTML里的图片路径可以直接用相对路径（或绝对路径）：

from PyQt5.QtWebEngineWidgets import QWebEngineView
from PyQt5.QtCore import QUrl

q = QWebEngineView()
# 传入图片所在目录作为baseUrl
q.setHtml(
    '''<img border="0" height="200" src="img.png" style="display: block; text-align: left;" width="600">''',
    QUrl.fromLocalFile("E:/")
)

方法2：使用file://协议格式的路径

直接在img的src属性中使用标准的本地文件URL格式（注意三个斜杠：file:/// + 本地路径）：

from PyQt5.QtWebEngineWidgets import QWebEngineView

q = QWebEngineView()
q.setHtml('''<img border="0" height="200" src="file:///E:/img.png" style="display: block; text-align: left;" width="600">''')

补充说明 #

• 网络图片和base64格式图片能正常显示，是因为它们的路径本身带有明确的协议标识（http/https或data协议），QWebEngineView可以直接识别。
• Chrome能加载本地路径的原因是，当它打开本地HTML文件时，会自动将文件所在目录作为基础URL，无需额外配置。

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