Readthedocs添加html_logo配置触发类型错误如何解决？

你在conf.py中定义html_logo参数时末尾多写了一个英文逗号，Python会自动将带尾部逗号的单元素值识别为元组类型，而非预期的字符串类型。Sphinx的路径拼接逻辑要求html_logo为字符串类型，传入元组就触发了本次的TypeError报错。

• 修改conf.py中的html_logo配置，删掉末尾的多余逗号，修改后配置如下：

html_logo = '_static/logo.png'

• 确认conf.py中已正确注册静态资源目录，确保存在如下配置（默认生成的Sphinx项目一般会自带该配置，缺失的话补充即可）：

html_static_path = ['_static']

修改完成后重新提交代码触发Read the Docs构建即可，你的项目目录结构中logo.png的存放路径符合配置要求，无需额外调整。

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