直接用BMap.Map加载万级点必然卡死，因默认Marker渲染依赖DOM节点，1000点即触发重排，1万点致页面失去响应；须改用PointCollection绕过DOM层，注意size设为数字、shape用合法字符串，并配合离线瓦片实现真流畅。
直接用 BMap.Map 加载万级点必然卡死
不是你代码写错了，是默认点标记渲染走 DOM 节点，1000 个点就触发重排，1 万点基本让页面失去响应。浏览器主线程被大量 div 插入和样式计算拖垮，哪怕数据已加载完成，地图也“动不了”。
必须绕过 DOM 渲染层：
• 优先用 PointCollection 替代 Marker 实例循环创建
• 确保调用前检查 window.BMap 已就绪（别在 mounted 里直接 new，要等 API 完全加载）
• PointCollection 不支持点击事件透传，需要自己用 map.pixelToPoint + map.pointToPixel 做坐标反查
PointCollection 的 size 和 shape 参数容易设错
官方文档写“size 默认 10×10px”，但实际是像素值，不是 CSS 单位；shape 只接受字符串 'circle'、'square'、'diamond'，传 'rect' 或数字会静默失败，点根本不显示。
常见错误：
• 把 size: '12px' 当成合法值（应为 size: 12）
• 用 shape: 0 模拟 switch 判断（无效，必须字符串）
• 忘记 setStyles 是覆盖式更新，多次调用不会叠加，要一次性传全量配置
调用百度PaddleOCR‑VL大模型API，支持PDF、Word、PPT、图片等多格式文档解析，精准识别印刷体、手写体、表格、公式、图表、印章等复杂元素，支持100+语言，可处理不规则布局和跨页长文档。触发词：文档解析、VLM解析、大模型OCR、PaddleOCR、多模态文档、手写识别、公式识别、复杂版面。
Symfony2 模板里混写 JS 容易引发加载时序问题
在 Twig 模板里直接写 <script>new BMap.Map(...)</script>，看似方便，但 Symfony 的输出缓冲、asset 版本哈希、CDN 缓存都可能让 JS 执行早于百度地图 SDK 加载完毕。
安全做法：
• 把地图初始化逻辑抽成独立 JS 文件，用 async 或 defer 加载
• 在 Twig 中只留容器 <div id="map"></div>，不塞脚本
• 使用 window.initBaiduMap = function() {...} 全局钩子，在百度 API onload 回调里触发
• 避免在 DOMContentLoaded 里初始化地图——此时 BMap 很可能还没挂到 window 上
离线瓦片 + PointCollection 组合才是真流畅
光优化前端打点没用，如果每次缩放都请求在线瓦片，网络延迟照样卡。尤其车机或弱网环境，首屏白屏 3 秒很常见。
关键动作：
• 用 SQLite 封装离线瓦片，建 (zoom, x, y) 联合索引
• 在 PHP 层用 Nginx alias 映射 /maptiles/{z}/{x}/{y}.png 到本地 DB 查询接口
• 前端地图初始化时设置 tileLayer 指向该本地地址，而非百度默认 CDN
• PointCollection 数据仍走 AJAX，但仅传输坐标数组，体积控制在 200KB 内（超了建议分页或聚类）
