如何在Office.js插件中创建章节交叉引用/链接？

问题原因 #

直接通过Range.hyperlink = "#_test"赋值触发异常，是因为该属性对格式的隐性限制较多，且部分场景下属于只读属性，官方更推荐使用专门的方法来添加指向书签的超链接。

正确实现方法 #

1. 创建目标书签 #

先为需要引用的章节（比如第1章引言）创建书签：

// targetRange为目标章节标题或内容的Range对象
targetRange.insertBookmark("_test");
await context.sync();

注意：书签名称不能包含空格或特殊字符，_test这类格式是合规的。

2. 插入带书签链接的引用文本 #

使用insertHyperlink方法添加带链接的引用语句，这是最稳定的实现方式：

// referenceRange为你要插入引用语句的位置Range
const referenceText = "更多信息请参见第1章：引言";
// 第三个参数控制插入位置：replace=替换当前范围内容，end=追加到范围末尾
await referenceRange.insertHyperlink(referenceText, "#_test", Word.InsertLocation.end);
await context.sync();

验证书签是否创建成功 #

如果不确定书签是否存在，可以通过以下代码验证：

const bookmark = context.document.bookmarks.getItem("_test");
bookmark.load("name");
await context.sync();
console.log("书签存在：", bookmark.name);

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