PyQt5窗口渲染HTML空白问题求助：本地HTML加载无显示

问题描述 #

作为PyQt5 GUI开发新手，尝试创建渲染本地HTML文件的窗口，运行后窗口空白。调试发现view.load()已执行（日志包含DrawChildren:2，推测对应HTML中的h1和p元素），但页面无内容显示。

附simple_test.html代码：

<!DOCTYPE html>
<html>
<body>

<h1>My First Heading</h1>
<p>My first paragraph.</p>

</body>
</html>

附原Python脚本代码：

from PyQt5.QtWidgets import QApplication, QMainWindow
from PyQt5 import QtWebEngineWidgets
import sys
import os

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("Feelings App Prototype")
        
        view = QtWebEngineWidgets.QWebEngineView()
        view.load(QUrl('html_files\simple_test.html'))

        self.setCentralWidget(view)

app = QApplication(sys.argv)

window = MainWindow()
window.show()

app.exec()

问题原因及解决步骤 #

1. 缺少QUrl的显式导入 #

原代码使用QUrl但未从PyQt5.QtCore模块导入，会导致运行报错（若未报错可能是环境隐式兼容，但规范写法必须显式导入）。

2. 本地文件路径加载方式错误 #

直接将相对路径字符串传给QUrl会被当作网络URL处理，而非本地文件，导致无法正确加载。Qt提供QUrl.fromLocalFile()方法专门处理本地文件路径，会自动添加file://协议并适配系统路径格式。

修正后的代码 #

from PyQt5.QtWidgets import QApplication, QMainWindow
from PyQt5 import QtWebEngineWidgets
from PyQt5.QtCore import QUrl  # 显式导入QUrl
import sys
import os

class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()

        self.setWindowTitle("Feelings App Prototype")
        
        view = QtWebEngineWidgets.QWebEngineView()
        # 构建正确的本地文件URL：先获取HTML文件绝对路径，再转成Qt识别的格式
        html_path = os.path.join(os.getcwd(), 'html_files', 'simple_test.html')
        view.load(QUrl.fromLocalFile(html_path))

        self.setCentralWidget(view)

app = QApplication(sys.argv)

window = MainWindow()
window.show()

app.exec()

额外说明 #

• 使用os.path.join()拼接路径可避免Windows和Linux系统的路径分隔符差异问题。
• 若HTML文件与Python脚本在同一目录，可直接传入文件名给QUrl.fromLocalFile()。

内容的提问来源于stack exchange，提问作者Jaimee-lee Lincoln