Google Apps Script 教学 课程 5：日志和调试

• 使用 Logger 记录日志
• 常见错误处理
• 调试技巧
• 捕获和处理异常

1. 使用 Logger 记录日志

步骤 1.1：Logger 的基础用法

• 介绍 Logger 对象是 Google Apps Script 中用于记录日志的工具。
• 记录简单消息：function logMessage() { Logger.log("This is a log message."); }
• 运行 logMessage 函数，查看执行日志。

步骤 1.2：记录变量值

• 使用 Logger 记录变量的值：function logVariable() { var name = "Alice"; Logger.log("Name: " + name); }
• 运行 logVariable 函数，查看日志中记录的变量值。

步骤 1.3：记录复杂数据

• 记录对象或数组的内容：function logComplexData() { var person = { firstName: "Alice", lastName: "Smith", age: 30 }; Logger.log(person); }
• 运行 logComplexData 函数，查看日志中记录的对象内容。

2. 常见错误处理

步骤 2.1：识别常见错误

• 语法错误、运行时错误和逻辑错误的区别。
• 示例：function commonErrors() { // 语法错误示例：缺少分号 // var name = "Alice" // 运行时错误示例：未定义的变量 // Logger.log(name); // 逻辑错误示例：不正确的条件 var age = 20; if (age > 30) { Logger.log("Age is greater than 30"); } else { Logger.log("Age is less than or equal to 30"); } }

步骤 2.2：调试常见错误

• 通过日志记录错误位置和变量值：function debugErrors() { var name = "Alice"; Logger.log("Before the error"); Logger.log(name); // 强制一个错误 var undefinedVariable; Logger.log(undefinedVariable.length); // 这里会产生错误 Logger.log("After the error"); // 这行代码不会被执行 }
• 运行 debugErrors 函数，查看日志和错误信息。

3. 调试技巧

步骤 3.1：分步调试

• 将复杂代码分解为小块，逐步测试每个部分：function stepByStepDebug() { var num1 = 10; var num2 = 5; Logger.log("Step 1: num1 = " + num1); Logger.log("Step 2: num2 = " + num2); var result = num1 / num2; Logger.log("Step 3: result = " + result); }
• 运行 stepByStepDebug 函数，逐步查看日志。

步骤 3.2：使用断点

• 介绍在调试模式下使用断点（需在 Apps Script 编辑器中进行）。
• 设置断点并运行代码，查看变量值和执行流程。

4. 捕获和处理异常

步骤 4.1：try…catch 语句

• 介绍使用 try...catch 捕获和处理异常：function handleException() { try { var num = 10; var result = num / 0; // 可能导致错误的代码 Logger.log(result); } catch (e) { Logger.log("An error occurred: " + e.message); } }
• 运行 handleException 函数，查看日志中的错误信息。

步骤 4.2：抛出异常

• 介绍如何使用 throw 手动抛出异常：function throwError() { try { var age = -1; if (age < 0) { throw new Error("Age cannot be negative"); } Logger.log("Age: " + age); } catch (e) { Logger.log("An error occurred: " + e.message); } }
• 运行 throwError 函数，查看日志中的手动抛出的错误信息。

实践练习

练习 1：使用 Logger 记录日志

• 创建一个脚本文件 LogMessages.gs，并编写以下代码：function logPractice() { var firstName = "Alice"; var lastName = "Smith"; var age = 30; Logger.log("First Name: " + firstName); Logger.log("Last Name: " + lastName); Logger.log("Age: " + age); }
• 运行 logPractice 函数，查看日志记录。

练习 2：捕获和处理异常

• 创建一个脚本文件 ExceptionHandling.gs，并编写以下代码：function exceptionPractice() { try { var data = null; Logger.log(data.length); // 这里会产生错误 } catch (e) { Logger.log("Caught an error: " + e.message); } }
• 运行 exceptionPractice 函数，查看日志中的错误处理信息。

总结

• 回顾本课程的学习内容：如何使用 Logger 记录日志、处理常见错误、调试技巧以及捕获和处理异常。
• 强调记录日志和调试的重要性，多练习调试技巧和异常处理方法。

通过以上详细的教学步骤，能够熟练使用 Logger 记录日志，处理常见错误，掌握调试技巧，并能有效地捕获和处理异常，提高代码质量和稳定性。