HTML构建时custom.css突然不可用，Content-Type异常求助

• 检查静态文件路径配置
  确认conf.py里的html_static_path正确指向存放custom.css的目录，示例配置：

  html_static_path = ['_static']
  

  同时确认custom.css确实在该目录下，无移动或重命名情况。

• 清理构建缓存
  旧缓存可能引发资源加载异常，执行清理后重新构建：

  # Linux/macOS
  make clean
  make html
  

  # Windows
  .\make.bat clean
  .\make.bat html
  

• 验证本地服务器配置
  若使用Sphinx自带本地预览服务器，尝试重启；若用第三方服务器，检查其对.css文件的MIME类型配置，确保未错误将css文件识别为html类型。

• 确认css文件引入配置
  检查conf.py中html_css_files是否正确引入custom.css：

  html_css_files = [
      'custom.css',
  ]
  

  路径需相对html_static_path，无需额外前缀。

• 检查文件权限
  Linux/macOS环境下，确保custom.css具备可读权限，权限不足可能导致服务器无法正确读取文件，进而返回错误的Content-Type。

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