为什么Windows系统下Excel中Office JS插入动态评论功能失效？

核心原因：API版本兼容性不足 #

Excel 评论操作相关的Workbook.comments系列接口，是在Excel API 1.10 版本才正式发布的。而Windows平台的Office 2016永久许可版（非365订阅分支）最高仅支持到Excel API 1.9，没有内置评论接口的实现，因此调用会直接失败。Mac版Office、Office 365订阅版均支持更高版本的API，所以运行无异常。

代码逻辑可优化点 #

你当前的写法存在不必要的嵌套ctx.sync，且调用getItemByCell后未同步就直接操作对象，在部分严格环境下可能会触发额外报错，优化后的新版评论接口写法参考：

await Excel.run(async (ctx) => {
  const address = "sheet!A4";
  const wb = ctx.workbook;
  // 先尝试获取已有评论
  const comment = wb.comments.getItemByCell(address);
  comment.delete();
  // 统一执行删除操作，捕获不存在的报错
  await ctx.sync().catch(error => {
    if (error.code !== Excel.ErrorCodes.itemNotFound) {
      throw error;
    }
  });
  // 新增评论
  wb.comments.add(address, "This is simple test comment");
  await ctx.sync();
  console.log("Add comment successfully!");
});

兼容Windows Office 2016的解决方案 #

如果必须适配Office 2016环境，可以使用旧版单元格笔记（Note）接口，该接口从Excel API 1.1开始就支持，兼容所有Office 2016版本：

await Excel.run(async (ctx) => {
  const sheet = ctx.workbook.worksheets.getItem("sheet");
  const range = sheet.getRange("A4");
  // 直接设置note即可，会自动覆盖已有内容
  range.note = "This is simple test comment";
  await ctx.sync();
  console.log("Add note successfully!");
});

如果需要使用评论的回复、提及等高级功能，只能引导用户升级到Office 2019及以上版本，或切换到Office 365订阅版，同时建议在代码入口增加API版本检测逻辑，不支持的环境直接给出友好提示，避免静默失败。

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