Zotero 官方版本历史显示，10.0.5 于 2026 年 9 月 30 日发布；这条记录本身并未说明 Word 插件故障由 Zotero 10 引起。遇到 Zotero 10 Mac Word 插件没反应，先在空白文档复现，再按“插件未加载、权限不足、启动文件夹异常、旧文档字段问题”分流，别一上来就反复重装。(Zotero 版本历史)
适合阅读的人：正在用 Zotero 10 和 Word 写论文，却找不到 Zotero 工具栏的研究生或科研人员，可以先核对插件安装与启动文件夹。
点击引用按钮没有响应、Word 提示无法连接 Zotero 的用户，可按应用状态和权限逐步定位。
如果只有旧论文报错、新建文档正常，重点应放在保护原稿和检查文档字段上。
截至 2026 年 10 月 6 日，本文已核对 Zotero 官方版本历史、Word 插件安装与排查文档，以及 Apple 的自动化权限说明。发布前若 Zotero、Word 或 macOS 更新改变相关步骤，应再复核官方说明。
先用空白文档判断故障在哪一层
别拿唯一的论文原稿做测试。先打开 Zotero 桌面应用和 Word，新建一个空白文档，尝试插入一条引用；记录工具栏是否出现、按钮是否有反应、是否出现权限提示，以及引文能否写入文档。
Zotero 官方也建议用新建空白文档区分插件问题和已有文档问题：如果空白文档正常，旧论文报错应转向文档排查；如果空白文档也失败，才继续检查插件、应用通信和权限。(Word 插件故障排查、Word 文档错误排查)
| 观察到的现象 | 更可能的故障范围 | 下一步 |
|---|---|---|
| Word 里没有 Zotero 工具栏 | 插件未安装、未加载，或启动文件夹不匹配 | 关闭 Word，从 Zotero 设置重新安装；再核对 Word 启动文件夹 |
| 工具栏在，但点击没有响应 | 旧模板、应用未运行，或自动化权限被拒绝 | 确认 Zotero 桌面应用正在运行，再检查插件与权限 |
| Word 提示无法与 Zotero 通信 | Zotero 未运行，或 Word 载入的插件版本有问题 | 重启两个应用；确认移除旧模板后重新安装 |
| 空白文档正常，只有旧论文出错 | 文档字段、修订状态或个别引文异常 | 复制原稿，在副本中检查并定位问题 |
这个区分能避免把“某份文档里的引文异常”误判成“整套插件坏了”，也能减少反复安装却没有改变故障原因的情况。
工具栏不见时，按加载顺序检查 Zotero.dotm
Zotero 的 Word 插件通常会随应用自动安装，也可以从 Zotero 设置中重新安装。操作前先完全退出 Word，再打开 Zotero 的“设置—引用—文字处理软件”，选择重新安装 Word 插件，然后重新启动 Word。(Zotero 插件安装说明、插件安装错误排查)
如果工具栏仍没出现，按下面的顺序检查：
- 在 Word 菜单中打开“工具—模板和加载项”，确认全局模板列表里有 Zotero.dotm，并且已勾选。菜单文字可能因 Word 版本或界面语言略有不同。
- 在 Word 的“设置—文件位置”中查看当前的“启动”文件夹。Word 实际读取的路径，才是确认模板是否放对位置的依据；不要只按网上旧路径猜测。
- 若需手动安装，从 Zotero 官方说明给出的应用目录找到 Zotero.dotm，将文件复制到当前启动文件夹，而不是移动原文件，再重启 Word。手动安装可能需要在插件更新后重复处理，能修复自动安装问题时，不宜长期把手动复制当成首选。(Mac 手动安装步骤及启动文件夹说明)
如果 Word 管理的启动文件夹和手动安装时选的目录不是同一个，模板即使存在，工具栏也可能仍然不出现。检查时还要留意账户是否有该目录的读写权限；若设备由学校统一管理、目录受策略限制，应联系校园 IT，而不是更改机构安全设置。
按钮有反应吗？继续区分通信、权限和模板
如果 Zotero 工具栏可见，但点击“添加引文”没有窗口或反应，先确认 Zotero 桌面应用正在运行；浏览器中的 Zotero Connector 或网页版页面不能替代桌面应用。然后重启 Word 和 Zotero，再回到空白文档复测。(插件无响应与通信错误排查)
仍无响应时，可重装插件，但先把旧模板彻底移除，避免 Word 继续载入原来的 Zotero.dotm：
- 退出 Word。
- 在 Word 当前使用的启动文件夹中找到 Zotero.dotm，将它移到废纸篓。
- 重开 Word，确认 Zotero 工具栏已消失；若仍在，说明活动启动文件夹里可能还有另一份模板。
- 退出 Word，再从 Zotero 设置重新安装插件。
- 重启 Word，在空白文档里分别确认工具栏可见、引用窗口能打开、引文成功写入。
这三项是不同的验收结果：工具栏出现不等于通信正常，引用窗口弹出也不等于引文已成功写入。应逐项确认，不要只看图标是否回来。
核对 macOS 自动化授权
macOS 会要求用户决定一个应用能否自动控制另一个应用。Zotero 的 Word 插件需要能够与 Word 交互；如果曾拒绝授权，可打开“系统设置—隐私与安全性—自动化”，展开 Zotero，并查看 Microsoft Word 是否允许。修改后重启 Word，再用空白文档复测。(Zotero 的 Word 自动化权限说明、Apple 的自动化控制设置说明)
如果看不到权限开关，或学校配置禁止修改，不要为了修插件关闭其他安全功能，也不要试图绕过管理限制。记录 macOS、Zotero 和 Word 版本、出现的提示，以及已经尝试过的步骤，再向校园 IT 或 Zotero 支持提交问题，方便对方判断是权限策略还是插件本身。
只有旧论文失败时，先把修复限制在副本
空白文档能正常插入引文，而旧论文仍报错时，不要继续反复重装插件。先复制论文文件，保留唯一原稿不动，再在副本中检查 Word 修订是否开启、报错是否总由某条引文触发，以及参考文献字段是否能正常识别。
复制文件副本后，依次做低风险测试：
- 在副本里暂时关闭修订，再重新触发报错位置。
- 检查报错附近是否有异常引文，或是否把引文放进不适合插入 Zotero 引文的位置，例如图片说明文字。
- 试着在副本中切换参考文献样式，观察故障是否仍出现。
- 若仍无法定位，可在副本中逐段缩小范围；每次操作后检查是否恢复，不在原稿里直接删除引文或字段。
Zotero 的文档排错说明也建议先复制文件用于调试，并可通过缩小出错内容范围来定位问题。将正文复制到新文档有时能作为进一步测试，但旧引文字段未必会自动识别，因此不要把它当作无损修复方式。(Zotero 的 Word 文档故障排查步骤)
常见问题：用症状而不是版本号推断原因
Zotero 10 更新后，Word 里的 Zotero 工具栏为什么看不到？
工具栏不显示不能直接证明是 Zotero 10 更新造成的。先退出 Word，在 Zotero 的“设置—引用—文字处理软件”中重新安装 Word 插件，再重启 Word；如果仍缺失，检查 Zotero.dotm 是否进入 Word 实际使用的启动文件夹，以及 Word 是否将该模板停用。
Mac 上 Zotero 已经打开，Word 还是插不进引文怎么办？
先在空白文档中复现，并确认运行的是 Zotero 桌面应用，而不是浏览器里的 Connector。若按钮点击后没有响应，重启两个应用；仍无效时，删除活动启动文件夹中的旧 Zotero.dotm，确认 Word 工具栏消失后再从 Zotero 设置重装，并核对自动化权限。
新文档能插入引用，只有旧论文出错，是文档损坏了吗？
这说明插件整体故障的可能性较低，但不能仅凭此断定文档损坏。先复制原文件作为测试副本，在副本中检查修订状态、参考文献字段和报错位置；可再尝试复制内容到新文档或逐段定位问题引文。不要在唯一原稿上删除字段或做破坏性修复。
macOS 的自动化授权会不会拦住 Zotero 与 Word 的交互？
会。Zotero 的 Word 插件需要 macOS 允许 Zotero 与 Word 交互；如果此前拒绝授权，可在“系统设置—隐私与安全性—自动化”中检查 Zotero 下的 Microsoft Word 开关，然后重启 Word。若设备由学校管理且设置不可更改，应联系校园 IT，不要尝试绕过管理策略。
复测结果不稳定时，再决定是否换环境验证
若故障偶尔出现、却会影响论文交付，可留一份最小复测记录：启动 Zotero 和 Word、打开空白文档、插入一条引文、生成参考文献，并记录每一步成功或失败。这个流程能帮助确认问题是否稳定复现，也能让技术支持看到故障停在哪一环。
如果手边没有可用 Mac，或问题只在特定 macOS 环境出现，远程 macOS 可以作为隔离测试环境的备选；但它不是修复本机权限或旧文档字段的必需条件。远程环境也不能替代论文原稿备份、校园授权核对或本机交付前验收。需要评估时，可先查看 RUVCLOUD 的 Mac 使用入口和方案与计费信息，再判断临时测试是否适合当前任务。
与借用实验室设备相比，设备未必随时可用，环境设置也可能受统一管理限制；反复在不同电脑上重装插件，还会增加路径和版本不一致的排查成本。若确实需要临时复现、又没有可用 Mac，租用 RUVCLOUD 的远程 Mac 可提供另一种测试路径；若问题只发生在一份旧文档，或长期依赖本机接口和稳定重负载，则先用现有 Mac 与文档副本排查更合适。