Sphinx配置sphinx_book_theme构建报sidebar-logo.html缺失错误

按以下步骤调整即可正常构建，不需要额外配置项目logo：

• 第一步先修正conf.py里的配置错误
  你当前配置里的language = 'python'是错的：这个参数是指定文档的展示自然语言（比如中文填zh_CN，英文填en），和代码高亮的语言没有关系，错误取值会干扰主题的模板加载逻辑。不需要多语言支持的话直接删掉这行，或者设为language = 'en'即可。
  另外不需要把sphinx_book_theme加到extensions列表里，这个主题只需要配置html_theme参数就能生效，写在extensions里会造成重复加载、模板路径识别冲突，把extensions里的对应项删掉就行。
  修正后的通用配置段参考：

  # -- General configuration ---------------------------------------------------
  extensions = []
  templates_path = ['_templates']
  exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
  

• 第二步对齐依赖版本
  你当前用的Sphinx 4.5.0版本过旧，新版sphinx-book-theme已经不再兼容Sphinx 4.x分支，执行以下命令升级核心依赖，补全主题依赖的模板组件：

  pip install --upgrade sphinx sphinx_book_theme pydata-sphinx-theme
  

• 特殊情况兜底处理
  如果做完前两步还是报sidebar-logo.html找不到的错误（一般是本地pip安装缓存损坏导致的文件缺失），不用找复杂的模板源码，直接在项目的_templates目录下新建一个名为sidebar-logo.html的空文件就行。因为你没有配置logo参数，这个空文件不会在页面渲染出任何多余内容，完全满足你暂时不配置logo的需求。

另外注意你用的构建命令参数写错了：sphinx-build的参数格式是sphinx-build 源码目录 输出目录，你之前写的sphinx-build docs . _build/html多传了一个路径参数，会导致构建时的路径识别异常。如果你的sphinx配置文件在根目录，就用sphinx-build . _build/html；如果配置文件在docs子目录里，就用sphinx-build docs _build/html。
调整完重新执行构建就能正常生成文档了。

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