什么是Install Chinese Fonts
该工具旨在解决 Linux 系统中文字体缺失或显示异常的问题，通过自动化脚本和发行版软件包管理的方式，帮助用户快速安装并配置完整的中文/CJK（中日韩）字体集。与手动下载庞大的上游字体归档文件相比，使用系统包管理器安装字体不仅体积更小、更新更便捷，还能显著提升可靠性。工具的核心目标是确保用户在命令行界面、图形应用、浏览器渲染、PDF 生成及截图等场景中能够正确显示汉字、日文和韩文字符，避免出现‘方块’或乱码现象。
该方案采用分层策略：优先推荐通过发行版的官方软件源安装预打包的 CJK 字体，例如 Debian/Ubuntu 上的 fonts-noto-cjk 或 RHEL/CentOS 系列中的 google-noto-cjk-fonts 系列包。只有在官方仓库缺乏所需字体或其版本不满足需求时，才建议用户回退到从上游（如 GitHub）手动下载特定字体家族，例如 Adobe 的 Source Han Sans（思源黑体）或 Source Han Serif（思源宋体）。整个过程强调轻量化、可重复性和系统兼容性，适用于大多数主流 Linux 发行环境。
此外，工具内置了字体缓存刷新机制（fc-cache -f），并在安装完成后自动验证 fontconfig 是否能识别新安装的中文字体家族。对于无图形界面的服务器环境，此方法同样有效，常用于保障 Chrome、Playwright、文档导出模块等在后台任务中正确渲染中文内容。若某些应用程序仍无法显示中文，通常只需重启该应用即可解决问题。
核心功能特点
- 支持主流 Linux 发行版（RHEL、Debian、Ubuntu 等）的包管理器一键安装中文/CJK 字体
- 优先使用发行版官方提供的 Noto CJK 字体包，确保体积小、更新及时且稳定可靠
- 提供自动化脚本实现重复部署，包含干跑模式、实际安装和仅验证三种执行方式
- 自动刷新 fontconfig 缓存并验证字体是否被系统正确识别
- 在官方仓库无合适字体时，支持从上游（如 GitHub）手动下载并安装 Source Han 系列字体
- 适用于服务器端中文显示、浏览器渲染、PDF 导出、截图及文档处理等多种无头环境场景
适用场景
该工具特别适合那些在 Linux 环境下遇到中文乱码或显示为‘方块’（tofu）问题的用户，无论是开发者在终端中使用 man 手册、查看日志文件，还是在 Web 应用中预览中文内容，都能从中受益。对于部署在无图形界面的远程服务器上运行的服务，如使用 Puppeteer、Playwright 或 wkhtmltopdf 进行网页抓取或 PDF 生成的自动化流程，正确安装中文字体至关重要——否则导出的文档或截图中将无法呈现可读的汉字。
此外，系统管理员或 DevOps 工程师在为生产环境配置新机器时，可通过此工具快速标准化字体配置，避免因字体缺失导致的监控面板、报表生成或日志解析问题。即使是在个人工作站上，若需运行依赖中文文本渲染的应用程序（如某些 IDE 的本地化插件、电子书阅读器或设计工具），也能借助该方案确保界面和输出内容完整无误。
值得一提的是，该工具不仅面向普通桌面用户，也高度适配容器化部署和持续集成/持续交付（CI/CD）流水线。例如，在 Docker 镜像构建过程中集成此脚本，可保证后续基于该镜像运行的任何服务均能正确处理中文字符，从而提升整体系统的国际化支持能力。