Bookdown bs4_book主题修改h3字体颜色不生效问题求助

解决方法 #

问题核心是bs4_book默认样式使用了优先级更高的选择器定义H3颜色，同时编译缓存、CSS加载顺序也可能导致自定义规则不生效，按以下步骤操作即可解决：

• 提升选择器优先级
  不要直接使用h3作为选择器，使用更具体的层级选择器覆盖默认样式，你可以通过F12开发者工具查看当前生效的H3默认样式对应的选择器，再写更高优先级的规则即可。bs4_book场景通用写法参考：

  .book .book-body .page-inner section.normal h3 {
    color: blue;
  }
  

  仍有冲突的话可以补充!important后缀，优先级足够的情况下可以省略该后缀。
• 确认_output.yml配置格式正确
  自定义CSS需要直接配置在bookdown::bs4_book参数下，不要错误嵌套在theme字段中，正确配置示例：

  output:
    bookdown::bs4_book:
      css: style.css
  

• 清除缓存重新编译
  1. 删除项目根目录下的_book缓存文件夹
  2. 重新运行bookdown编译命令生成电子书
  3. 打开页面后按Ctrl+Shift+R（Windows/Linux）或Cmd+Shift+R（Mac）执行硬刷新，清空浏览器本地缓存的旧样式。

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