如何配置ReadTheDocs将缺失版本重定向至latest版本
2026-6-16
解决Read the Docs未知版本重定向到latest的问题
你可以通过正则表达式匹配的重定向规则实现这个需求，完全不需要硬编码具体版本号。具体操作如下：
- 进入你的Read the Docs项目设置页面，找到「重定向规则」选项
- 添加一条正则类型的重定向规则：
- 来源路径：
^/en/(?!latest|stable|\d+\.\d+\.\d+)/
其中\d+\.\d+\.\d+用来匹配你已发布的语义化版本号格式（比如x.y.z），(?!...)是负向预查逻辑，会排除掉已存在的版本（包括latest、stable这类官方别名，以及所有已发布的具体版本号） - 目标路径：
/en/latest/ - 规则类型选择「正则表达式」
- 来源路径：
设置完成后：
- 已存在的版本（比如
myproject.readthedocs.io/en/8.1.1/）会正常访问，不会触发重定向 - 任何未匹配到已存在版本的路径（比如
myproject.readthedocs.io/en/8.2.0/）都会自动跳转到latest版本文档，不会出现404页面
如果你的项目版本号格式不是x.y.z（比如是x.y），只需要调整正则里的版本匹配部分，改成\d+\.\d+即可。
内容的提问来源于stack exchange，提问作者Mattia Verga
相关产品推荐
相关产品推荐
