为什么自定义CSS文件在Read the Docs站点上无法正常生效？

• 默认主题版本迭代
  你使用的 sphinx-rtd-theme 官方近期有版本更新，调整了原有样式的类名、页面结构或默认样式优先级，你之前编写的.wy前缀类匹配规则不再适配新结构，或者被优先级更高的默认样式覆盖。如果你的文档配置没有固定主题版本，Read the Docs 自动构建时会拉取最新版主题，就会出现样式突然失效的问题。
• CSS 加载顺序变更
  如果当前自定义CSS的加载顺序早于平台默认样式文件，同权重的自定义样式会被后续加载的默认样式覆盖。你可以给自定义CSS的属性后添加!important声明强制提升优先级，例如width: 320px !important;，测试样式是否能恢复生效。
• 自定义CSS未被正确引入
  打开站点的浏览器开发者工具，切换到网络面板刷新页面，检查自定义CSS文件的请求状态：如果返回404，说明自定义CSS的存放路径不符合当前平台的静态文件规则，或是conf.py中的html_css_files配置项被误删、修改，导致构建时没有引入该文件；如果没有对应的CSS请求，也属于引入配置失效的情况。
• 构建缓存异常
  Read the Docs 的构建缓存可能出现异常，导致最近的构建未使用你提交的CSS文件，而是沿用了旧的无自定义样式的构建产物，你可以手动触发一次全新的版本构建，清空缓存后重新验证样式效果。

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