前言：

宏代码的调试在宏代码实际开发中是非常重要的手段，对于调试工具的使用在宏代码调试中的必备技能。在Smartbi中宏代码类型分为客户端宏和服务端宏两种类型，故本次课程主要通过客户端宏调试和服务端宏调试两个部分进行讲解Smartbi中宏代码调试工具的使用和技巧的运用。

客户端宏调试：

客户端宏实际上是在浏览器运行的，所以我们可以使用浏览器的开发者工具进行调试。

1.如何打开浏览器的开发者工具？

如图以谷歌浏览器为例，可在浏览器中打开选中自定义控制在【更多工具】中找到【开发者工具】或使用相应的快捷方式：Ctrl+Shift+I，或者使用F12快捷键打开开发者工具。

注：F12快捷键虽然是诸多主流浏览器打开开发者工具的快捷键，但是并不是所有浏览器都适用。

2.客户端宏调试方式及步骤：

断点调试：

1.可在宏代码中添加：debugger

2.按F12进入开发者工具界面

3.打开报表，触发报表宏，进入调试界面（或者在宏管理触发生效）

使用技巧：

F10单行调用执行

F11方法体函数执行

F8直接跳过执行

注：在调试仪表盘宏的时候需要在url中添加：?debug=true，若不添加无法进入断点调试。

控制台调试：

1.可以在宏代码中使用console.log()等进行控制台打印输出相应变量

2.按F12进入开发者工具界面

3.打开报表，触发报表宏，进入调试界面（或者在宏管理触发生效）

服务端宏调试：

由于服务端宏是在服务端进行执行的，我们无法对相应的进行的代码打断点调试，因此我们只能通过打印日志的方式进行调试相关代码。

如图，我们可以使用logger对象的中的相关方法进行打印日志，从而对服务端宏代码进行调试。

如何查看打印日志信息呢？

1.在【运维设置】找到调试工具集：

打开调试工具集中的宏控制台，可以查看到服务端宏的日志输出：

注：打印的时候只能打印具体的值，而不能打印输出具体的对象（输出的会是对象在JVM中的地址值）

2.可以在【系统监控】【日志】或在【用户日志】中开启监控进行获取日志打印信息。

总结：

在Smartbi中宏代码的调试在实际开发中具有多维度的重要性，能够显著提升开发效率与代码质量。通过宏代码调试可以明确代码执行流程与逻辑、精准定位问题与异常、验证功能实现与兼容性。通过客户端与服务端调试的结合、日志与断点技术的运用，开发者能够高效实现从功能验证到性能优化的全流程控制。

视频教学：

宏代码调试：https://my.smartbi.com.cn/edu/course-134