在Google Sheets外部库中使用JavaScript原型函数遇阻求助

没错，你碰到的这个问题是Google Apps Script库的一个明确限制——没法通过外部库来扩展String这类原生对象的原型。

背后的原因 #

Google Apps Script的库运行在独立的隔离上下文里，库中的代码只能修改自己环境里的原生对象原型，根本碰不到主项目（项目2）里的String原型。所以你在项目1（库）里给String.prototype加的newStringFunc，只在库自己的执行环境里有效，主项目的字符串对象完全不知道这个方法存在，自然会报TypeError。

至于你说的常规函数能正常调用，那是因为库的普通函数会被暴露到主项目的命名空间里（比如你的库名.常规函数()），但原型扩展是直接修改全局原生对象，这种跨环境的修改GAS是不允许的。

两种替代方案 #

方案1：把原型方法改成普通工具函数

把原来的原型逻辑封装成库的普通函数，调用时传入字符串参数就行：
项目1（库）代码：

function newStringFunc(str) {
  Logger.log(str.toString());
}

项目2调用代码：

function test() {
  var s = "Hello";
  // 替换成你的库实际名称，比如MyStringLib
  MyStringLib.newStringFunc(s);
}

方案2：通过库导出初始化函数，在主项目中修改原型

如果你一定要保留.newStringFunc()的调用方式，可以在库中写一个初始化函数，然后在主项目里调用它，让主项目自己修改String原型：
项目1（库）代码：

function initStringPrototype() {
  if (!String.prototype.newStringFunc) {
    String.prototype.newStringFunc = function() {
      Logger.log(this.toString());
    };
  }
}

项目2调用代码：

function test() {
  // 先调用初始化，确保原型方法被添加到主项目的String上
  MyStringLib.initStringPrototype();
  var s = "Hello";
  s.newStringFunc();
}

注意：每次主项目执行相关逻辑前，都要确保初始化函数已经被调用过，不然还是会报错。

总结 #

GAS的隔离机制决定了库没法直接修改主项目的原生对象原型，所以只能通过上面两种方式来实现类似的功能。

内容的提问来源于stack exchange，提问作者OJNSim