常见问题

本文档整理了用户在使用千字网CDN时可能遇到的常见问题及详细解答。

基础问题

千字网CDN是什么？

千字网CDN是一个完全免费的公益字体CDN项目，致力于为中文互联网提供稳定、快速的字体服务。所有资源托管于 Codeberg Pages，配合 Cloudflare 全球加速，确保稳定访问。

如何开始使用？

浏览字体列表，找到需要的字体
在CSS中引用字体文件
设置 font-family 属性

详细步骤请参考使用教程。

服务是免费的吗？

是的，千字网CDN完全免费。我们依赖 Codeberg Pages、Cloudflare 等公益平台提供服务，站长自掏腰包维护加速节点。

字体使用

如何找到字体文件夹名和族名？

查看 font_mapping.toml 文件。

文件夹名：URL中使用，如 Source+Han+Sans+VF
族名：CSS中使用，将 + 替换为空格，如 'Source Han Sans VF'

如何引用字体？

在CSS中引用：

@import url("https://hanzi.itedev.com/fonts/字体文件夹/result.css");

body {
    font-family: '字体族名';
}

字体支持粗体/斜体吗？

不支持粗体和斜体变体。

本站理念是"能用CSS修改的，就不用字体变体"。通过 font-weight: bold 和 font-style: italic 可以获得粗体和斜体效果。

如需精确的字体变体，推荐使用中文网字计划。

可以商用吗？

请查看各字体的开源许可证。本站仅提供CDN服务，字体版权归各自作者所有。

性能优化

访问速度慢怎么办？

推荐使用加速域名：

@import url("https://hanzi.itedev.com/fonts/字体文件夹/result.css");

感谢 minc-nice-100 提供的加速服务。

需要加载所有字体吗？

不建议。引用 main.css 会加载所有字体，页面加载会非常慢。

正确做法：只引用你需要的具体字体。

如何优化字体加载？

只引用需要的字体：避免加载不必要的字体文件
使用加速域名：选择离用户更近的CDN节点
设置 font-display：使用 font-display: swap 提升加载体验
预加载关键字体：使用 <link rel="preload"> 预加载

技术问题

字体无法加载怎么办？

检查URL是否正确：确认字体文件夹名拼写无误
检查网络连接：确保能访问CDN域名
查看浏览器控制台：检查是否有CORS或404错误
尝试其他域名：使用备用域名测试

支持哪些浏览器？

千字网CDN使用标准的 WebFont 格式（WOFF2），支持所有现代浏览器：

Chrome 36+
Firefox 39+
Safari 10+
Edge 14+

不支持 IE 浏览器。

字体文件大小是多少？

经过拆包优化后，单个字体文件通常在 100KB-500KB 之间，具体取决于页面使用的字符数量。

授权与商用

字体授权情况如何？

请查看各字体的开源许可证。本站收录的字体大多为开源字体，但具体授权信息请参考字体原始发布页面。

可以修改字体吗？

请遵守字体的开源许可证。大多数开源字体允许修改，但需要保留原始版权信息。

如何联系字体作者？

请查看字体原始发布页面，通常包含作者联系方式。