Sphinx Read the Docs未从GitHub更新问题求助

• 检查Read the Docs项目的构建触发器设置
  确认是否开启「GitHub推送自动构建」，进入项目Settings → Integrations查看GitHub webhook是否正常启用。同时查看Builds页面是否有触发记录，若没有则说明推送事件未传递到平台。

• 核对代码分支一致性
  确认Read the Docs配置的构建分支（如main）和你修改代码的分支完全一致，避免因分支不匹配导致更新不触发。

• 排查构建日志错误
  进入Builds页面查看最近一次构建的日志，检查是否存在Sphinx编译错误，比如usage.rst的语法问题、依赖缺失、文件路径错误等，这些会导致构建失败从而不更新文档。

• 验证访问令牌权限
  确认更新后的访问令牌拥有仓库读取权限，且未过期、绑定了正确的仓库，权限不足会导致平台无法拉取最新代码。

• 手动触发构建测试
  在项目页面点击「Build version」手动触发构建，若手动构建成功则说明自动触发器存在问题；若手动也失败，重点关注构建日志中的错误信息。

• 排查前端缓存问题
  尝试强制刷新浏览器（Ctrl+F5），或在文档URL后添加?v=随机数绕过缓存，确认是否是前端缓存导致的旧内容显示。

• 检查平台服务状态
  查看Read the Docs官方运维公告，确认是否存在平台服务故障或维护，这类情况会导致构建队列堵塞。

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