新建Google Sheet重命名后插件持续加载，是代码问题还是默认行为？

问题复现场景 #

新建Google Sheet后将默认名称「Untitled spreadsheet」重命名，已安装的插件进入无限加载状态，仅手动刷新页面可临时恢复。

常见诱因 #

Google Sheet重命名操作会触发文档元数据更新，大部分插件初始化时会绑定首次加载的文档元数据，若未适配元数据变更场景就会出现状态卡死。

排查与修复方案 #

确认是否为插件原生问题 #

• 新建空白Google Sheet，不添加任何自定义代码，重命名后观察对应插件是否仍卡加载。如果复现，说明该插件未适配Google Sheet重命名场景，可向插件开发者提交反馈要求适配文档名称变更事件。

自定义代码兼容修复（针对自行开发的插件/脚本） #

• 检查初始化逻辑，避免将文档名称作为唯一判断条件或缓存key，建议改用SpreadsheetApp.getActiveSpreadsheet().getId()作为唯一标识，不受名称变更影响。
• 添加onChange触发器监听重命名事件，主动重置插件状态，参考代码如下：

function onChange(e) {
  // 监听重命名事件
  if (e.changeType === 'RENAME') {
    // 重置插件本地缓存、重新拉取文档配置完成初始化
    const ss = SpreadsheetApp.getActiveSpreadsheet();
    console.log('文档已重命名为：', ss.getName());
    // 此处补充你的插件重新初始化逻辑
  }
}

• 若无需本地缓存，可在插件appsscript.json配置文件中添加"useLocalStorage": false，避免旧名称缓存导致状态冲突。

内容的提问来源于stack exchange，提问作者Deepak Singh Negi