常见问题

💡 快速导航

本页面整理了用户最常遇到的问题，帮助您快速找到解决方案

🎯 基础问题

千字网 CDN 是什么？

千字网 CDN 是一个完全免费的公益字体 CDN 项目，致力于为中文互联网提供稳定、快速的字体服务。

核心特点：

• 🎨 托管于 Codeberg Pages
• ⚡ 配合 Cloudflare 全球加速
• 💎 确保稳定访问
• 🌐 毫秒级响应体验

如何开始使用？

只需三步即可开始：

1. 📋 浏览 字体列表，找到需要的字体
2. 🔗 在 CSS 中引用字体文件
3. ✨ 设置 font-family 属性

详细教程

查看完整的 使用教程，了解更多细节

服务是免费的吗？

是的，完全免费！ 🎉

千字网 CDN 依赖以下公益平台提供服务：

• Codeberg Pages - 免费托管
• Cloudflare - 全球 CDN 加速
• 站长自掏腰包 - 维护加速节点

可持续性

虽然服务免费，但维护成本不低。如果这个项目对您有帮助，欢迎通过 捐款通道 支持我们！

---

🎨 字体使用

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

查看 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: '字体族名', sans-serif;
}

完整示例：

@import url("https://hanzi.itedev.com/fonts/Source+Han+Sans+VF/result.css");

body {
    font-family: 'Source Han Sans VF', sans-serif;
}

字体支持粗体/斜体吗？

不支持粗体和斜体变体。

设计理念："能用 CSS 修改的，就不用字体变体"

解决方案：

/* 粗体效果 */
.bold-text {
    font-weight: bold; /* 或 700 */
}

/* 斜体效果 */
.italic-text {
    font-style: italic;
}

需要精确字体变体？

推荐使用 中文网字计划

可以商用吗？

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

常见许可证：

• SIL Open Font License - 允许商用，需保留版权声明
• Apache License - 允许商用，需保留版权声明
• 自定义许可证 - 请查看字体原始发布页面

---

⚡ 性能优化

访问速度慢怎么办？

推荐使用加速域名：

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

域名对比：

域名	速度	推荐度
hanzi.itedev.com	最快	⭐⭐⭐⭐⭐
hanzi.qzz.io	快	⭐⭐⭐⭐
hanzi.bluu.pl	一般	⭐⭐⭐

特别感谢

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

需要加载所有字体吗？

强烈不建议！ ❌

错误做法：

/* 加载所有字体，页面会非常慢 */
@import url('https://hanzi.bluu.pl/main.css');

正确做法：

/* 只引用需要的字体 */
@import url("https://hanzi.itedev.com/fonts/Source+Han+Sans+VF/result.css");

原因：

• 🚫 加载所有字体会导致页面加载极慢
• 🚫 浪费带宽资源
• 🚫 严重影响用户体验

如何优化字体加载？

优化建议：

✅ 只引用需要的字体

避免加载不必要的字体文件

🌐 使用加速域名

选择离用户更近的 CDN 节点

⚡ 设置 font-display

使用 `swap` 提升加载体验

🔄 预加载关键字体

使用 `` 预加载

---

🔧 技术问题

字体无法加载怎么办？

排查步骤：

1. 检查 URL 是否正确

   • 确认字体文件夹名拼写无误
   • 注意大小写敏感

2. 检查网络连接

   • 确保能访问 CDN 域名
   • 尝试在浏览器中直接访问字体 URL

3. 查看浏览器控制台

   • 打开开发者工具（F12）
   • 查看 Console 标签是否有错误
   • 查看 Network 标签，确认请求状态

4. 尝试其他域名

   • 使用备用域名测试
   • 排除域名问题

常见错误代码：

错误码	说明	解决方案
404	字体文件不存在	检查 URL 拼写
CORS	跨域问题	检查域名配置
Timeout	连接超时	尝试其他域名

支持哪些浏览器？

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

支持列表：

浏览器	最低版本	状态
Chrome	36+	✅ 完全支持
Firefox	39+	✅ 完全支持
Safari	10+	✅ 完全支持
Edge	14+	✅ 完全支持
IE	-	❌ 不支持

IE 浏览器

不支持 IE 浏览器。如需支持 IE，请使用其他字体服务

字体文件大小是多少？

经过拆包优化后，单个字体文件通常在 100KB-500KB 之间。

影响因素：

• 页面使用的字符数量
• 字体复杂度
• 压缩算法

优化建议：

• 使用中文网字计划的切割工具进一步优化
• 只加载页面实际使用的字符

---

📜 授权与商用

字体授权情况如何？

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

常见许可证类型：

许可证	商用	修改	要求
SIL OFL	✅	✅	保留版权声明
Apache 2.0	✅	✅	保留版权声明
MIT	✅	✅	保留版权声明
自定义	请查看	请查看	请查看许可证

可以修改字体吗？

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

修改注意事项：

• ✅ 保留原始版权声明
• ✅ 遵守许可证要求
• ✅ 标注修改内容

如何联系字体作者？

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

查找途径：

1. 字体原始发布网站
2. GitHub/GitLab 仓库
3. 字体文件元数据

---

🆘 更多帮助

如果以上问题没有解决您的疑问，欢迎通过以下方式获取帮助：

📖 使用教程

详细的使用指南和示例代码

查看教程 →

🔧 故障排查

解决技术问题的详细指南

查看指南 →

💡 最佳实践

优化字体使用的专业建议

查看实践 →

📧 联系站长

直接发送邮件咨询

发送邮件 →

---

💬 社区支持

您也可以在 Codeberg 项目页面 提交 Issue 或 Pull Request，与社区一起完善这个项目！