renderjs 无法操作 Vue 模板 DOM，因其运行在独立原生渲染层，与 Vue 逻辑层隔离；仅能操作自身创建的 canvas 或绝对定位 div；需通过 uni.$emit/props 通信，不可监听 data 变化或调用 Vue API。
renderjs 不能直接操作 Vue 模板里的 DOM
renderjs 的 document 是独立上下文，和 Vue 渲染层完全隔离——你在 renderjs 里用 document.getElementById 找不到 <view id="box">，哪怕它真在页面上。这是因为 uni-app 的 Vue 层运行在逻辑层（JSCore/V8），而 renderjs 运行在原生渲染层（iOS CoreAnimation / Android RenderThread），两者不共享 DOM 树。
实操建议：
- 只对
<canvas>或自定义<div>（通过style="position: absolute"+z-index叠在顶层）这类 renderjs 自己创建的节点操作 - 若需响应 Vue 数据变化，必须通过
uni.$emit/uni.$on或props传入初始配置，不要试图在 renderjs 里监听data变化 - 避免在 renderjs 中调用
querySelectorAll查找 Vue 模板元素，100% 返回空 NodeList
renderjs 引入后 canvas 无法触发 touch 事件
renderjs 创建的 <canvas> 默认拦截所有触摸，但 uni-app 的 @touchstart 等事件绑定在 Vue 层，根本收不到穿透过来的原始事件。
实操建议：
- 在 renderjs 的
canvas上手动调用canvas.addEventListener('touchstart', ...)，自己处理坐标、手势逻辑 - 如需和 Vue 层协同，用
uni.$emit('canvas-touch', {x, y})主动通知，别依赖事件冒泡 - 注意 iOS 下
canvas的touch-action: none会禁用双指缩放等原生行为，按需设置 CSS
renderjs 中 this.$scope 拿不到 Vue 实例方法
this.$scope 是 renderjs 提供的桥接对象，但它只暴露了 Vue 实例的 data 和 methods 中**显式声明为可访问**的部分，且仅支持同步调用。常见错误是直接写 this.$scope.handleTap() 却报 undefined。
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
实操建议：
- Vue 组件中必须在
export default里把要暴露的方法挂到methods，且不能是箭头函数 - renderjs 调用前先检查：
if (typeof this.$scope.handleTap === 'function') - 异步逻辑（比如调用
uni.showToast）必须放在 Vue 方法内部完成，renderjs 不支持直接调用 API - 频繁通信会卡顿，单次传递数据量别超 1MB，否则 Android 上可能触发
RangeError: Maximum call stack size exceeded
Android 上 renderjs canvas 渲染错位或闪烁
这是最隐蔽的坑：Android 原生渲染线程对 canvas 尺寸计算有缓存，当父容器宽高由 Vue 响应式动态改变（比如折叠面板展开）时，renderjs 里的 canvas.width/height 不会自动同步，导致绘制区域偏移、内容被裁切或反复重绘闪烁。
实操建议：
- 监听 Vue 层尺寸变化，用
this.$scope.$forceUpdate()触发 renderjs 重绘（注意这不是 Vue 的$forceUpdate） - 每次绘制前手动重设 canvas 尺寸：
canvas.width = canvas.offsetWidth; canvas.height = canvas.offsetHeight; - 避免在
mounted里一次性初始化 canvas，改用$nextTick确保 DOM 已就绪 - 开启硬件加速：
canvas.style.transform = 'translateZ(0)'，能缓解部分机型闪烁
renderjs 的边界很清晰：它不是“另一个 Vue”，而是给高性能图形、粒子、实时滤镜留的窄通道。一旦开始想用它替代 v-if 或接管滚动逻辑，八成已经在踩坑路上了。
