常见问题

适合谁看：页面字体没换、目录异常，或怀疑插件会不会切字时。

页面上字体没换

按顺序查：

1. 文风云开了吗？ 默认关闭，不开不会加载远程样式链接。
2. 有没有已确认的脸，或字体名 / 项目名？ 都空时，前台故意不输出链接。
3. 文风 API Key 通过了吗？ 到工具页再检查一次；Key 只在服务器校验，无效时按提示处理。
4. 走的是文风字体包？ 确认包已安装且已启用；再看包健康提示（缺 local.css / 无可用 woff2 / 已启用但不会加载）。
5. font-family 是否和实际声明一致？ 选用应是 wenfeng-* 这类 fontFamily，不要只抄显示名。自 2.0.0-rc.8 起，新装的本站包也会尽量登记成同一短名。

手工贴文风样式链接的对照步骤，见《网页字体引用与 CDN 接入》。

切片包里还是 WF-，装完怎么变成 wenfeng-？

属预期（2.0.0-rc.8）。安装时插件会把能识别的 WF-* / windfonts-* 对齐成 wenfeng-{short}，并把写入的 local.css 里的 font-family 改成同一短名；woff2 文件名不动。认不出时回退 zip 文件名。已经装好的旧包不会自动改；要得到新登记，请升到 rc.8 后重新拖入 zip。细节见《文风字体包》。

侧栏改了字，为什么全站排版没变？

属预期。侧栏「文派字库」只改当前块。要进全站排版，请启用文风字体包或确认文风云脸，再到 外观 → 编辑器 → 样式 → 排版。见《编辑器与全局样式》。

外观 → 样式里突然多了字体

属预期。自 2.0.0-rc.5 起，已启用的文风字体包、以及已确认可用的文风云字体脸，会自动写入用户全局样式，可在 外观 → 编辑器 → 样式 → 排版 看见。自 rc.7 起可同步多张云字脸。它们来自插件同步，不是主题被改过。

系统 · 某语种在字体库里不见了

到 设置 → 文派字库 → 设置 看四个勾选框（系统 · 中文 / 英文 / 日文 / 韩文）。默认全开；取消勾选的语种不会登记进字体库。重新勾选并保存即可。

停用包 / 去掉一张云字脸之后，排版里怎么还有字？

要区分两类东西：

• 插件同步写入的条目：停用 / 删除包，或从已确认列表去掉某张脸后，插件会只移除自己为该项写入的条目。
• 你在站点编辑器里已经选中、落到块或样式上的值：可能仍留在用户全局样式或块属性里，需要在编辑器里改回。

卸了插件，样式还在

全局样式归 WordPress（用户 wp_global_styles），不是主题文件。卸载插件会清设置与目录快照等插件数据，但不会删除用户全局样式。若排版还指着已卸掉的字体，请在站点编辑器里改回。

导出文件里有没有 API Key？导入为何整份拒绝？

自 2.0.0-rc.7 起，设置 → 文派字库 → 工具 可导出已启用包元数据与已确认云字脸。导出文件不含 API Key。若你手头的文件里仍带有 Key（例如旧备份或手工拼的），导入会整份拒绝，不会半套写入。

公开样式 404 时会嵌入吗？

不会。公开样式返回非 CSS / 404 时，插件不嵌入该链接，也不宣称已加载。

目录是空的

本机还没有成功的 catalog.json 快照。可点「更新字体目录」，或先手填 wenfeng-*。打开设置页本身不会自动去拉文风。

更新失败，仍看见旧目录

这是预期行为：失败不会盖好快照。修好网络或稍后再点更新；冷却大约 60 秒。

插件会切字吗？会改主题吗？

不会切字，也不会写 theme.json / 主题文件。 切分字体在文风完成。插件只消费文风云样式链接，或安装已切好的文风字体包，并把启用项同步进字体库与用户全局样式。装包时改写的是本站写出的 local.css 族名，不是源切片工程。

和手动贴文风样式链接是什么关系？

同一类远程嵌入。手动贴链接灵活；插件帮你管开关、服务器、多张已确认脸、字符范围和 Key 校验，少拼地址。项目白名单仍在文风控制台配置。