在 Sphinx 中，我收到大量警告，例如：

/PATH/FILENAME:LINE: WARNING: duplicate label LABELNAME, other instance in /PATH/FILENAME

似乎将所有节标题视为“标签”，并且有一堆节标题在多个文件中使用。 例如，我们每个版本的每个发行说明都有一页，并且每个版本中都有“改进”和“修复”。

如何摆脱所有这些警告？是否应该将它们静音，或者是否有您应该使用的不同切片方法？

一个例子是标签“gamepad”桌面.rst https://github.com/kasenvr/vircadia-docs-sphinx/blob/master/docs/source/explore/get-started/desktop.rst and VR-controls.rst https://github.com/kasenvr/vircadia-docs-sphinx/blob/master/docs/source/explore/get-started/vr-controls.rst

作为参考，我们仍然使用Sphinx 2.4.4 我在变更日志中没有看到任何似乎相关的内容。

As recommonmark已弃用 https://github.com/readthedocs/recommonmark/issues/221, use myst-parser https://www.sphinx-doc.org/en/master/usage/markdown.html反而：

pip install --upgrade myst-parser

# and inside conf.py:
extensions = ['myst_parser', ...]

尽管采用了这种设置，我仍然有相同的重复标签警告。原来我必须删除'sphinx.ext.autosectionlabel'从我的extensions列出来解决问题。