如何用Google AppScript实现Google Docs输入时的字符替换（支持词内替换）

刚好之前帮朋友做过类似的需求，给你一套完整的实现方案，完全支持实时输入时替换，而且能处理单词内部的字符替换，完美匹配你的要求。

一、核心思路 #

咱们利用Google Docs内置的onEdit触发器，用户每输入一次文本就自动触发替换逻辑。为了不拖慢文档速度，我们不会每次都扫描整个文档，只针对刚编辑的那一小段文本处理，既高效又精准。

二、完整代码实现 #

打开你的Google Docs，点击顶部的「扩展程序」→「Apps Script」，把下面的代码粘贴进去就行：

// 这里定义你的字符替换规则：左边是要换掉的字符，右边是替换后的目标字符
// 你可以随便加，支持单个字符、特殊符号甚至中文
const CHAR_REPLACE_MAP = {
  'a': 'α',
  'b': 'β',
  'c': 'γ',
  'x': '×',
  'y': '÷',
  // 举个中文例子：把“旧”换成“新”
  '旧': '新'
};

function onEdit(e) {
  // 先判断是不是在Docs里的编辑事件，避免触发其他无关操作
  if (!e || e.source.getType() !== DocumentApp.DocumentType.DOCUMENT) return;

  const doc = e.source;
  let targetElement;

  // 处理两种情况：用户选中了一段文本，或者只是光标处输入
  const selection = doc.getSelection();
  if (selection) {
    targetElement = selection.getRangeElements()[0].getElement();
  } else {
    const cursor = doc.getCursor();
    if (!cursor) return;
    targetElement = cursor.getSurroundingText().getElement();
  }

  // 获取当前要处理的文本内容
  let currentText = targetElement.getText();
  let updatedText = currentText;

  // 遍历替换规则，把所有匹配的字符都换掉（包括单词内部）
  for (const [originalChar, targetChar] of Object.entries(CHAR_REPLACE_MAP)) {
    // 用全局正则替换，确保所有出现的字符都被替换
    const replaceRegex = new RegExp(originalChar, 'g');
    updatedText = updatedText.replace(replaceRegex, targetChar);
  }

  // 如果文本有变化，就更新内容，同时恢复光标位置
  if (updatedText !== currentText) {
    // 先记下来光标原来的位置，避免替换后光标乱跑
    const cursorOffset = doc.getCursor().getOffset();
    targetElement.setText(updatedText);
    // 把光标放回原来的位置（如果替换后字符长度变了，可以再优化偏移量）
    doc.setCursor(doc.getBody().newPosition(targetElement, cursorOffset));
  }
}

三、关键细节说明 #

• 自定义替换规则：你只需要修改CHAR_REPLACE_MAP这个对象就行，想换什么字符就加什么键值对，多字符组合也支持（比如'abc': 'xyz'）。
• 实时触发：onEdit是Google Docs的内置触发器，用户输入时会自动跑这个函数，不需要手动设置，第一次运行授权就行。
• 单词内部替换：用正则的g标志做全局替换，不管字符在单词开头、中间还是结尾，都会被替换，比如输入apple会变成αpple（如果你的规则是a→α）。
• 光标体验优化：替换后会把光标放回原来的位置，不会打断你的输入节奏，这点很重要。

四、使用步骤 #

1. 把代码粘贴到Apps Script编辑器后，点击顶部的「运行」按钮，按照提示给脚本授权（这是安全的，只有你能访问自己的文档）。
2. 回到你的Google Docs，输入包含替换规则里的字符，比如输入abcxy，会实时变成αβγ×÷，试试在单词中间输入，比如helloa会变成hellαa，完全符合你的需求。

五、可选优化（进阶） #

如果替换的字符长度不一样（比如把ab换成XYZ），光标位置可能会偏移，你可以加一段代码调整偏移量：

// 在替换后计算新的光标位置
const originalCharLength = originalChar.length;
const targetCharLength = targetChar.length;
const diff = targetCharLength - originalCharLength;
// 统计替换了多少次，计算偏移量
const replaceCount = (updatedText.match(new RegExp(originalChar, 'g')) || []).length;
const newCursorOffset = cursorOffset + diff * replaceCount;
doc.setCursor(doc.getBody().newPosition(targetElement, newCursorOffset));

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