Google Apps Script支持为Google Sheets、Docs、Slides等应用添加自定义菜单，让用户可以直接通过界面操作触发脚本逻辑，无需手动运行编辑器中的函数。自定义菜单的创建需要遵循特定的语法规则，同时要注意运行环境和权限的相关限制。
自定义菜单的基础创建步骤
自定义菜单需要在脚本的onOpen触发函数中定义，这个函数在用户打开对应的Google Workspace文件时会自动执行。基础的菜单创建代码如下：
function onOpen() {
// 获取当前文件的UI实例
const ui = DocumentApp.getUi();
// 创建顶级菜单，名称为"自定义工具"
const menu = ui.createMenu("自定义工具");
// 添加子菜单项，第一个参数是显示名称，第二个参数是点击后触发的函数名
menu.addItem("生成报告", "generateReport")
.addSeparator() // 添加分隔线
.addItem("清空数据", "clearData")
.addToUi(); // 将菜单添加到界面
}
// 菜单项对应的执行函数
function generateReport() {
const doc = DocumentApp.getActiveDocument();
const body = doc.getBody();
body.appendParagraph("这是自动生成的报告内容");
}
function clearData() {
const doc = DocumentApp.getActiveDocument();
const body = doc.getBody();
body.clear();
}
常见错误及解决方法
错误1：菜单不显示
菜单不显示是最常见的问题，通常由以下原因导致：
- onOpen函数未正确定义：函数名必须严格为
onOpen，不能拼写错误，也不能修改为其他名称，否则触发器无法自动识别。 - 脚本未授权：首次运行脚本时，需要用户手动授权脚本访问对应文件的权限。可以在编辑器中选择
onOpen函数，点击运行，按照弹窗提示完成授权，之后打开文件时菜单就会正常显示。 - 文件类型不匹配：如果脚本是为Google Sheets编写的，却绑定到了Google Docs文件上，
SpreadsheetApp.getUi()的调用会报错，导致菜单无法生成。需要根据文件类型选择对应的UI获取方法，比如Sheets用SpreadsheetApp.getUi()，Docs用DocumentApp.getUi()。
错误2：点击菜单项无响应
点击菜单项后没有任何反应，通常和函数定义有关：
- 绑定的函数名不存在：
addItem方法的第二个参数需要和脚本中实际定义的函数名完全一致，包括大小写。比如菜单绑定的是generateReport，但脚本中函数名写成了GenerateReport，点击后就会触发错误。 - 函数存在语法错误：如果绑定的函数本身有语法问题，点击菜单项后不会弹出明显的报错提示，只会在后台执行失败。可以在编辑器中单独运行对应的函数，排查语法问题。
错误3：权限不足报错
点击菜单项后弹出权限不足的错误，通常是因为函数需要额外的权限，但用户没有授予。比如菜单项函数需要发送邮件，就需要邮件相关的权限。解决方法是在编辑器中手动运行一次该函数，完成对应权限的授权，之后通过菜单点击就可以正常执行。
自定义菜单的进阶注意事项
除了基础的错误排查，还有一些细节可以提升菜单的使用体验：
- 菜单名称尽量简洁明确，避免使用过于生僻的词汇，让用户能快速理解菜单项的功能。
- 如果菜单项对应的功能执行时间较长，可以在函数开头添加加载提示，比如用
ui.alert("正在处理，请稍候")提示用户，避免用户以为点击没有生效。 - 不要在一个菜单中添加过多的子项，过多的选项会让用户难以查找需要的功能，可以按照功能分类拆分为多个顶级菜单。
注意：自定义菜单只在对应的文件打开时显示，如果用户同时打开了多个同类型的文件，每个文件的菜单都是独立绑定的，不会互相影响。
完整示例：Sheets自定义菜单
以下是一个Google Sheets的自定义菜单完整示例，包含数据整理和导出两个功能：
function onOpen() {
const ui = SpreadsheetApp.getUi();
ui.createMenu("数据工具")
.addItem("整理当前表格", "sortSheet")
.addItem("导出为CSV", "exportCsv")
.addToUi();
}
function sortSheet() {
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getDataRange();
// 按照第一列升序排序
range.sort({column: 1, ascending: true});
SpreadsheetApp.getUi().alert("表格整理完成");
}
function exportCsv() {
const sheet = SpreadsheetApp.getActiveSheet();
const data = sheet.getDataRange().getValues();
let csvContent = "";
data.forEach(row => {
csvContent += row.join(",") + "n";
});
// 这里可以将csv内容保存到Drive或者发送给用户
const ui = SpreadsheetApp.getUi();
ui.alert("CSV内容已生成，长度为" + csvContent.length + "字符");
}
Google_Apps_Script自定义菜单UI设计脚本错误排查修改时间：2026-07-20 00:00:29