Wicked PDF字体修改失效求助：基础字体设置无响应

我之前也碰到过Wicked PDF结合Bootstrap时字体无法自定义的情况，本质就是CSS优先级或者加载顺序的问题，给你几个靠谱的解决思路，按推荐程度排序：

1. 重写Bootstrap变量（最优雅的方式） #

既然你的pdf样式表已经在导入Bootstrap的变量和混合宏，那直接在导入前覆盖字体相关的变量就行，这样生成的Bootstrap样式从根源上就用你要的字体，不用事后覆盖：

// 在pdf.scss最开头先重写变量
$font-family-sans-serif: "Times New Roman", Times, Serif;
$font-family-base: $font-family-sans-serif; // 把基础字体设为你要的

// 再导入Bootstrap的变量、混合宏和栅格
@import "bootstrap/variables";
@import "bootstrap/mixins";
// 导入你需要的Bootstrap其他模块（比如栅格）
@import "bootstrap/grid";

这样Bootstrap生成的所有默认样式都会用你指定的字体族，后续的自定义样式也不会冲突。

2. 调整样式表加载顺序 #

如果不想改Bootstrap变量，那确保你的proficiency_card样式表在Bootstrap相关的pdf样式表之后加载。因为CSS规则是后加载的会覆盖先加载的同优先级规则：

比如在你的Rails布局文件里，把样式表的顺序改成：

<%= stylesheet_link_tag 'pdf', 'proficiency_card', media: 'all' %>

然后在proficiency_card.css里针对全局元素设置字体：

body, html, p, h1, h2, h3, h4, h5, h6, .container, .row, [class^="col-"] {
  font-family: "Times New Roman", Times, Serif;
}

这里列了Bootstrap常用的容器和排版元素，确保覆盖到所有可能被Bootstrap设置了字体的地方。

3. 提高样式优先级（紧急方案） #

如果上面两种方法都没生效，可以用!important强制覆盖（尽量少用，避免样式混乱，但针对PDF场景偶尔可以用）：

* {
  font-family: "Times New Roman", Times, Serif !important;
}

或者更精准地指定元素：

body, .card, .card-body, p, h1 {
  font-family: "Times New Roman", Times, Serif !important;
}

4. 检查字体嵌入情况（服务器端可能的坑） #

如果是Linux服务器部署，系统可能没有预装Times New Roman这类Windows字体，导致Wicked PDF无法渲染该字体。这时候需要手动嵌入字体：

1. 把字体文件（比如times.ttf）放到app/assets/fonts目录下
2. 在样式里定义@font-face：

@font-face {
  font-family: "Times New Roman";
  src: url("/assets/times.ttf") format("truetype");
  font-weight: normal;
  font-style: normal;
}

3. 在Wicked PDF的生成配置里指定字体路径：

render pdf: "proficiency_card",
       font_path: Rails.root.join("app", "assets", "fonts"),
       allow_unsafe_content: true # 允许加载本地字体

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