概述 #

SmartChart 提供了两种调试方式：仪表盘级日志和图形级 log() 函数。相比打开浏览器 F12 控制台，SmartChart 的内置日志系统更适合大屏开发场景，可以直接在页面上看到日志输出和图形序号，快速定位问题。

在仪表盘中开启日志显示 #

点击仪表盘顶部菜单中的日志开关，即可切换日志显示状态：

开启后，页面刷新或图形执行时，日志会直接显示在页面右下角，并标注出对应出错图形的序号，方便快速定位：

在图形中使用 log() 打印日志 #

SmartChart 提供了专用的 log() 函数，用法与 Python 的 print 类似（新版本已从 print 改为 log）。

// 打印变量值
log(dataset)

// 打印 ECharts 事件参数（鼠标悬停/点击时查看数据结构）
myChart__name__.on('mouseover', function(params) {
    log(params)   // 在编辑器和页面右下角都能看到 params 的完整结构
})

// 打印普通信息
log('当前城市：' + ds_param('city'))

log() 的智能开关机制 #

log() 函数与仪表盘的日志开关联动：

• 仪表盘日志开启时：log() 正常输出到页面右下角和浏览器控制台
• 仪表盘日志关闭时：log() 不会打印任何内容，不影响生产环境性能

这意味着你可以放心在代码中保留 log() 语句，上线后只需关闭仪表盘日志开关，调试代码无需清理。

实时坐标显示 #

利用日志功能还可以实现实时显示鼠标拖拽坐标，在精确定位图形元素位置时非常实用：

调试建议 #