PyQt中Folium地图显示过大内容受限问题及解决方案求助

问题背景 #

使用PyQt6.5.3结合folium开发地图项目时，遇到两个问题：

1. setHtml()因Chromium内核限制，无法加载超过2MB的HTML内容；
2. 尝试保存为本地HTML后用load()加载，出现js: Uncaught ReferenceError: L is not defined错误。

解决方案 #

1. 修复本地文件加载的代码错误 #

你尝试的代码中存在变量名错误：html_map未定义，且未将本地文件路径转换为QWebEngineView可识别的URL对象。正确代码如下：

import os
from PyQt6.QtCore import QUrl

# ... 你的folium地图生成代码 ...

temp_file_name = os.path.join(os.getcwd(), "temp_map.html")
m.save(temp_file_name)
# 将本地文件路径转为QUrl并加载
self.web_view.load(QUrl.fromLocalFile(temp_file_name))

这是解决“L is not defined”的首要步骤——错误的路径导致HTML未被正确加载，Leaflet的JS库自然无法初始化。

2. 解决Leaflet资源加载失败问题 #

若修复路径后仍报错，通常是folium默认依赖的CDN资源加载失败，可通过两种方式处理：

方案A：使用本地Leaflet资源

1. 下载Leaflet的leaflet.js和leaflet.css文件，放在项目目录的leaflet子文件夹中；
2. 创建folium地图时指定本地资源路径：

m = folium.Map(
    location=[36.429, 127.977],
    scrollWheelZoom=True,
    tiles='cartodbdark_matter',
    zoom_start=6.5,
    script_path='./leaflet/leaflet.js',
    css_path='./leaflet/leaflet.css'
)

方案B：确保QWebEngineView允许加载远程资源

检查并启用必要的网页设置，确保CDN资源能正常加载：

from PyQt6.QtWebEngineWidgets import QWebEngineSettings

# 启用JavaScript和本地文件访问远程资源的权限
self.web_view.settings().setAttribute(QWebEngineSettings.WebAttribute.JavascriptEnabled, True)
self.web_view.settings().setAttribute(QWebEngineSettings.WebAttribute.LocalContentCanAccessRemoteUrls, True)

3. 绕过setHtml()的2MB限制的总结 #

Chromium对setHtml()的2MB限制是硬约束，无法直接绕过。最优替代方案就是将folium地图保存为本地HTML文件，再通过load(QUrl.fromLocalFile())加载，这也是处理大体积HTML内容的标准做法。

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