QtWebEngine能否实现平滑滚动？问题排查与方案问询

QtWebEngine可以通过调整内部配置实现无JS的HTML平滑滚动，以下是具体可行的方案：

1. 启用滚动动画器并调整滚轮步长 #

单独启用ScrollAnimatorEnabled可能效果不明显，需要配合减小滚轮滚动步长，让每次滚动的距离更细腻，动画效果才能显现：

import sys
from PyQt6.QtWidgets import QApplication
from PyQt6.QtWebEngineWidgets import QWebEngineSettings

app = QApplication(sys.argv)
# 减小滚轮单次滚动的行数，默认值为3，设为1会让滚动更平缓
app.setWheelScrollLines(1)

# 启用WebEngine的滚动动画器
settings = QWebEngineSettings.globalSettings()
settings.setAttribute(QWebEngineSettings.WebAttribute.ScrollAnimatorEnabled, True)

2. 配置Chromium内核启动参数 #

--enable-smooth-scrolling是Chromium的原生参数，但不能直接传给QApplication，需要通过QWebEngineProfile配置（有效性取决于QtWebEngine绑定的Chromium版本）：

from PyQt6.QtWebEngineCore import QWebEngineProfile

profile = QWebEngineProfile.defaultProfile()
# 向Chromium内核传递平滑滚动参数
profile.setCommandLineArguments(["--enable-smooth-scrolling"])

3. 确认版本兼容性 #

确保使用的PyQt6-WebEngine和Qt6版本在6.2及以上，旧版本对滚动动画的支持存在局限性。可以通过以下代码检查版本：

import PyQt6.QtWebEngineWidgets
print("PyQt6-WebEngine版本:", PyQt6.QtWebEngineWidgets.__version__)

如果以上原生方案仍无法达到预期的平滑度，再考虑使用JS库作为补充方案，但通过调整上述配置，多数场景下可以实现原生平滑滚动效果。

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