chinese_font_library

Package Overview

Package selection guidance compiled from public package information, community data, and project usage.

A Flutter package designed to simplify the rendering of Chinese text across platforms. It provides automatic font family fallback and a dynamic font loader to ensure consistent display of Chinese characters on Android, iOS, macOS, Windows, and Linux. The library handles font loading and selection transparently, reducing setup complexity for developers. Ideal for apps requiring reliable Chinese typography without manual font configuration.

Use cases

Displaying Chinese text in cross-platform apps
Automating font fallback for Chinese characters
Loading custom Chinese fonts at runtime
Supporting multilingual apps with Chinese content
Ensuring consistent Chinese typography across devices

Key features

Cross-platform Chinese font support
Automatic font family fallback
Dynamic font loader
Minimal setup required
Supports all major desktop and mobile platforms

Suitable for

Apps targeting Chinese-speaking audiences
Developers needing reliable Chinese text rendering
Projects with complex multilingual requirements
Teams prioritizing platform consistency
Applications using custom or system Chinese fonts

Considerations

Requires proper font file inclusion in assets
May increase app size with embedded fonts
Limited to Chinese character sets
Depends on correct asset path configuration
Not intended for non-Chinese text rendering

Original README

Original README snapshot from the linked source repository. Visit the repository for the latest content.

chinese_font_library 意在优化中文字体的跨平台渲染，目前支持：

多字重的渲染
动态加载字体

Sponsor

本项目由庞征博引赞助：把复杂主题拆成一篇篇 5–10 分钟的阅读，边读边问，按自己的节奏慢慢学懂。

Requirements

chinese_font_library	Flutter	Dart
1.3.0	`>=3.41.0`	`>=3.11.0`
1.2.0	`>=3.22.0`	`>=2.19.0`

Flutter 3.41 起，框架会自动把 TextStyle.fontWeight 映射到可变字体的 wght 轴，本包也随之改用 FontWeight.value，因此 FontWeight(550) 这类非整百字重不再被向下取整。

Install

dependencies:
  chinese_font_library: ^1.3.0

Features

多字重的渲染

Flutter 使用的系统默认字体多为西文字体，因此不同平台下的中文字体通常渲染为 normal 字重或 bold 字重，且 bold 字重为计算后得到的字重，并非原生 bold 字重，严重影响观感。

解决方案为使用 .useSystemChineseFont() 修改已有的 textStyle:

Text(
  '你好世界 hello world',
  style: const TextStyle(fontWeight: FontWeight.w100).useSystemChineseFont(),
)

或者使用 .useSystemChineseFont() 修改已有的 textTheme:

return MaterialApp(
  theme: ThemeData(
    textTheme: yourCustomTextTheme.useSystemChineseFont(Brightness.light),
  ),
);

也可以使用 .useSystemChineseFont() 修改已有的 themeData:

return MaterialApp(
  theme: yourCustomThemeData.useSystemChineseFont(Brightness.light),
);

动态加载字体

如果您不满足于系统内置的中文字体，想使用自己精选的中文字体，而中文字体通常体积较大，放在安装包中并非最佳选择。

解决方案为通过网络动态加载字体，仅需下载一次：

DynamicFont.url(
  fontFamily: 'CustomFontFromWeb',
  url:
      'https://raw.githubusercontent.com/LastMonopoly/chinese_font_library/master/example/assets/SmileySans-Oblique.ttf',
).load();

也支持从 asset 与本地文件加载：

DynamicFont.asset(fontFamily: 'CustomFont', key: 'assets/MyFont.ttf').load();
DynamicFont.file(fontFamily: 'CustomFont', filepath: '/path/to/MyFont.ttf').load();

Results

Roadmap

如有任何意见或建议，请在 Github 上联系我。（❔ 表示尚未在真机上验证）

iOS	华为鸿蒙	小米 miui	macOS	Windows	Web html	荣耀	Vivo	Oppo	Linux
✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	✔️	❔

Reference

Flutter 小技巧之玩转字体渲染和问题修复

Contributions

LiTang0908

Search packages, repositories and app categories