在本地托管 Google 字体

本地加载 Google 字体选项会下载主主题设置中选择的受支持的 Google 字体，并从您的网站提供服务。这消除了浏览器向 Google 请求本地存储的字体变体的请求，并让您对字体交付有更多控制。

WoodMart 性能测试证实，本地提供 Google 字体比从 Google CDN 加载相同字体能提供更好的 LCP 结果。它移除了额外的外部连接，并允许浏览器更快地检索所需的字体文件，这在文本是最大内容绘制元素时尤为重要。

本地托管还通过避免对本地存储的字体变体发起 Google 请求来支持隐私要求，尽管仅此选项并不能保证完全符合 GDPR。在主主题设置之外添加的字体可能仍需要使用 Google CDN。

启用本地 Google 字体

1. 导航至 仪表盘 → 主题设置 → 性能 → 字体与图标。

2. 启用 本地加载 Google 字体。

3. 保存主题设置。WoodMart 会下载所需的字体文件并构建相应的本地 CSS。保存可能需要几秒钟，因为需要检索文件。

4. 导航至 仪表盘 → WoodMart → 状态 并找到 本地 Google 字体。此部分列出了本地托管的字体族、失败的下载以及上次更新时间。

本地存储的内容

WoodMart 会下载在主题设置下的主要排版控件中选择的 Google 字体族和变体。物理字体文件存储在：

wp-content/uploads/woodmart/google-fonts/fonts

生成的 @font-face CSS 通过 WoodMart 的内部 CSS 存储进行管理。其物理位置可能有所不同，因此您不应手动编辑或移动生成的文件。

可能仍会使用 Google CDN 的字体

本地缓存是根据主要主题设置构建的。仅在以下位置使用的字体或变体不会自动添加到该缓存中：

• 主题设置预设。
• Elementor 元素控件。
• WPBakery 元素控件。
• Gutenberg 块控件。

如果本地缓存中已存在相同的字体族和字重，WoodMart 可以重用本地变体。任何本地不可用的额外字体族、字重或样式将从 Google CDN 加载。

例如，如果主要主题设置使用字重 400，而某个预设使用字重 700，则字重 400 可以保持本地加载，而字重 700 将从 Google 请求。

管理本地字体

• 失败的下载： 主题设置会显示通知，受影响的字体族会出现在 仪表盘 → WoodMart → 状态 下。
• 回退： 当本地字体族或变体不可用时，WoodMart 会从 Google CDN 加载缺失的字体。刷新失败不会移除先前有效的本地缓存。
• 重新下载： 在状态页面上点击 重新下载本地 Google 字体 以根据当前排版设置重建缓存。
• 主题更新： 主题更新后，WoodMart 会自动重建本地字体缓存。
• 禁用： 禁用 本地加载 Google 字体 并保存主题设置会移除本地存储的字体文件和缓存数据。

配置 font-display

“font-display” 用于文本字体选项控制用于 Google 字体的 CSS font-display 值。当启用本地字体托管时，保存新的全局值会使用该值重建本地 CSS。

仅通过主题设置预设应用的 font-display 值不会添加到全局本地字体缓存中。因此，使用该预设的页面可能会从 Google CDN 加载所需的字体变体。

验证外部字体请求

清除网站和浏览器缓存后，在隐私浏览窗口中打开页面，并检查浏览器开发者工具中的网络面板。搜索对 fonts.googleapis.com 和 fonts.gstatic.com 的请求。

如果这些请求仍然存在，请检查页面是否使用了仅在预设、页面构建器元素、Gutenberg 块、插件或自定义代码中配置的字体族、字重或样式。