Sphinx 4.4.0及以上版本如何抑制sphinx.ext.extlink扩展报告的硬编码链接警告？

Hey，我之前也被这个警告烦过！Sphinx 4.4.0之后加的这个extlinks检测确实会在大量硬编码URL的时候弹出一堆警告，不想改链接的话，有几个靠谱的办法能关掉它们：

方法1：修改配置文件一劳永逸 #

直接在你的文档项目的conf.py里添加suppress_warnings配置，把对应的警告类型加进去就行：

# conf.py 中添加这一行
suppress_warnings = ['ref.extlinks']

这样所有的这类警告都会被直接抑制，是最省心的方案。

方法2：构建时用命令行临时抑制 #

如果不想改动配置文件，每次运行构建命令的时候，可以通过参数指定忽略这个警告：

sphinx-build -b html docs build/html --suppress-warning ref.extlinks

这种方式适合临时构建测试，或者不想修改全局配置的场景。

方法3：针对单个文件取消警告 #

要是你只想忽略某几个文件里的警告，而不是全部，可以在目标.rst文件的顶部添加Sphinx的抑制指令：

.. suppress-warnings:: ref.extlinks

这样这个文件里的硬编码URL就不会触发警告了，灵活性更高。

这些方法都亲测有效，我自己平时用方法1最多，一次配置就不用管啦～

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