如何将Google Docs对话框输入的变量传入绑定脚本以实现书籍章节自动重编号

先理清楚你代码里的几个核心问题，这些问题直接导致了输入无法正确传递、功能异常：

主要问题点 #

• HTML中google.script.run语法错误：你在调用reChapter1后多写了一个.，导致reChapter2无法被执行，这是最直接的语法bug。
• 函数重名覆盖：你定义了两个replaceIt函数，后面的会直接覆盖前面的，导致替换逻辑完全混乱。
• 隐式全局变量隐患：replaceIt里直接使用newText，但这个变量是在其他函数里定义的，属于隐式全局变量，容易引发不可预期的错误。
• 未处理字符串转数字：用户输入的是字符串类型，直接用于循环会导致非预期行为。
• 冗余循环逻辑：原代码里循环n次调用替换函数其实没必要，不过先保留你原本的逻辑框架再优化。

修正后的完整代码 #

Google Apps Script 代码 #

function onOpen() {
  var ui = DocumentApp.getUi();
  ui.createMenu('Custom')
    .addItem('Renumber Chapters', 'showDialog')
    .addToUi();
}

function showDialog() {
  var html = HtmlService.createHtmlOutputFromFile('Index')
    .setWidth(400)
    .setHeight(300);
  DocumentApp.getUi()
    .showModalDialog(html, 'Data Entry');
}

// 第一步：将所有带编号的章节替换为占位符「Chapter_」
function reChapter1(uObj){
  var body = DocumentApp.getActiveDocument().getBody();
  var numChaps = parseInt(uObj.numChaps, 10); // 把输入转成数字
  var replaceTerm = "Chapter [0-9]+";
  
  // 循环替换，没找到匹配项就提前退出
  for (var i = 0; i < numChaps; i++) {
    var newText = "Chapter_";
    var isFound = replaceIt(replaceTerm, body, newText);
    if (!isFound) break;
  }
  // 第一步完成后自动执行第二步
  reChapter2(uObj);
}

// 第二步：将占位符替换为连续编号的章节
function reChapter2(uObj){
  var body = DocumentApp.getActiveDocument().getBody();
  var numChaps = parseInt(uObj.numChaps, 10);
  var replaceTerm = "Chapter_";
  
  for (var i = 0; i < numChaps; i++) {
    var num = i + 1;
    var newText = "Chapter " + num;
    var isFound = replaceIt(replaceTerm, body, newText);
    if (!isFound) break;
  }
  // 给用户完成提示
  DocumentApp.getUi().alert("章节重编号已完成！");
}

// 通用替换函数，显式传递所有需要的参数
function replaceIt(replaceTerm, body, newText) {
  var found = body.findText(replaceTerm);
  if (found) {
    var start = found.getStartOffset();
    var end = found.getEndOffsetInclusive();
    var text = found.getElement().asText();
    text.deleteText(start, end);
    text.insertText(start, newText);
    return true; // 返回替换成功状态
  }
  return false; // 返回未找到匹配项
}

Index.html 代码 #

<!DOCTYPE html>
<html>
  <head>
    <base target="_top">
    <style>
      body { padding: 15px; font-family: Arial, sans-serif; }
      .input-area { text-align: center; margin-bottom: 15px; }
      .note { font-size: 12px; color: #666; text-align: left; margin-top: 10px; }
      .red-note { color: #dc3545; font-size: 12px; text-align: center; }
      button { padding: 8px 20px; cursor: pointer; }
      input { padding: 6px; width: 120px; }
    </style>
  </head>
  <body>
    <div class="input-area">
      <p>请输入当前章节数加十的数值*</p>
      <input id="numChaps" type="number" placeholder="例如：40" min="1"><br><br>
      <button onclick="saveUserInput()">开始重编号章节</button>
    </div>
    <div class="red-note">点击对话框右上角的"X"可关闭窗口</div>
    <div class="note">
      *例如：如果当前有30个章节需要重编号，请输入40。额外的10是预留空间，以防你有非连续的章节编号且不确定具体数量。
    </div>

    <script>
      function saveUserInput() {
        var numChapsInput = document.getElementById('numChaps');
        var numChaps = numChapsInput.value.trim();
        
        // 验证输入有效性
        if (!numChaps || isNaN(numChaps) || parseInt(numChaps) < 1) {
          alert("请输入有效的正整数！");
          numChapsInput.focus();
          return;
        }

        // 调用GAS函数，添加错误处理
        google.script.run
          .withFailureHandler(function(error) {
            alert("执行出错：" + error.message);
          })
          .reChapter1({numChaps: numChaps});
        
        // 自动关闭对话框
        google.script.host.close();
      }
    </script>
  </body>
</html>

关键改进说明 #

1. 修复异步调用语法：移除了HTML中多余的.，并改为在GAS内部串联两步操作，避免异步调用的顺序问题。
2. 合并优化替换函数：将两个重名的replaceIt合并为一个通用函数，通过参数传递替换文本，彻底解决函数覆盖和全局变量的问题。
3. 添加输入验证：在前端验证用户输入是否为有效正整数，避免无效输入导致的脚本错误。
4. 数字类型转换：将用户输入的字符串转为整数，确保循环逻辑正常执行。
5. 优化循环逻辑：添加匹配状态判断，没找到目标就提前退出循环，减少不必要的执行。
6. 用户反馈机制：添加完成提示和错误处理，让用户清晰知道执行状态。

这样修改后，你就能通过对话框输入章节数，脚本会自动完成两步替换，实现动态的章节重编号了。

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