Microsoft Translator Text API破坏notranslate span标签问题求助

我碰到过不少开发者遇到类似的情况——用<span class="notranslate"></span>包裹不需要翻译的内容，大部分时候没问题，但偶尔API会把这些标签直接剥离，只留下里面的文本。尤其是当标签内内容很短（比如单个数字）或者前后文本衔接紧密时，这种情况更容易发生。下面给你几个实用的解决办法：

• 改用官方专属的notranslate标记
  微软翻译API其实支持原生的[[notranslate]]包裹语法，这个比HTML标签的兼容性更好，API会明确识别并保留里面的内容不翻译。比如：
  输入：some [[notranslate]]1[[/notranslate]] text
  翻译后能稳定保留未翻译的内容，而且不会破坏格式。如果之前用的是HTML标签，可以批量替换成这种格式。

• 给notranslate标签增加辨识度
  如果必须保留HTML标签，可以给span添加额外的属性或者插入零宽空格这类不可见字符，让API更清晰地识别这是需要保留的元素：
  示例1（加自定义属性）：
  some <span class="notranslate" data-preserve="true">1</span> text
  示例2（加零宽空格）：
  some <span class="notranslate">1&#8203;</span> text
  这些小改动能降低API误解析的概率。

• 调用API时指定AllowListedTags参数
  在发起翻译请求时，设置AllowListedTags参数为["span"]，这样API会保留所有span标签，而不是仅识别notranslate类。不过要注意，如果文本里还有其他不需要保留的span标签，后续需要额外处理过滤。

• 占位符替换法（最稳妥的方案）
  这是我在复杂场景下最常用的方法：先把所有<span class="notranslate">...</span>内的内容替换成唯一的占位符（比如__FIXED_CONTENT_001__），翻译完成后再把占位符替换回原内容。步骤如下：

  1. 预处理原文本：some <span class="notranslate">1</span> another text → some __FIXED_CONTENT_001__ another text
  2. 调用API翻译预处理后的文本
  3. 把翻译结果里的占位符替换回原始内容，得到最终结果：деякий <span class="notranslate">1</span> інший текст
     这种方法完全不受API解析逻辑的影响，适合任何复杂场景。

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