关于 google-fonts
google-fonts 是面向网页项目的排版系统生成器,提供可搜索的 Google Fonts 字体资料、配对数据和模块化字号比例。它帮助设计师和开发者选择字体,并生成 CSS、Tailwind 配置及嵌入链接。
主要功能
- 01搜索和筛选字体资料
- 02查找推荐字体配对
- 03查询字体详情和字号比例
- 04生成 CSS 与 Tailwind 设置
- 05浏览 100 个排版系统示例
适用场景
- 01为网页产品挑选字体
- 02搭配标题与正文的字体
- 03创建响应式字号比例
- 04按项目类型查看系统示例
MCP 相关
连接 google-fonts MCP 服务时,技能建议优先使用其 search_fonts、generate_typography_system、lookup_font、list_scales 和 list_pairings 工具。仅安装技能时可改用脚本。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ sliday/ google-fonts-skill --skill google-fonts安装后在 Claude Code 中输入/google-fonts确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
LICENSECLAUDE.mdCHANGELOG.md.gitignoreREADME.mdpyproject.tomlcommunity-announcement.md.claude-plugin/marketplace.jsonplugin.json.github/dependabot.yml.github/workflows/pages.ymlpublish.ymldata/scales.csvpairings.csvreferences/pairing-principles.mdtypographic-rhythm.mdregistry/awesome-mcp-servers.mdmcp-hub.jsonsmithery.yamlscripts/build-pairings.pycore.pygenerate-llms-full.pygenerate-css.pyfetch-and-enrich.pygenerate-og-images.pysearch.pygenerate-showcase.pyshowcase/.nojekyllshowcase/pages/anthem-brands.htmlaether-analytics.html详细介绍
Auto Google Font
面向 Web 项目的 Google Fonts 字体排版系统生成器。搜索 1,923 种字体,并为其补充字体排印风格标签(几何、人文主义、新哥特式等)、对比度等级和正文适用性评级。生成完整的字体排版节奏系统。
数据文件
data/fonts.csv— 1,923 种 Google Fonts,包含:Family、Category、Stroke、Personality、Expressive、Contrast、Width、Styles、Weight_Range、Variable、Variable_Axes、Body_Suitable、Quality_Tier(A/B/C)、Popularity_Rank、Mood、Best_For、Keywords、Subsets、Google_Fonts_URL、CSS_Importdata/pairings.csv— 73 组经过验证的字体配对,包含对比类型和比例建议data/scales.csv— 8 种模块化字体比例,包含字号、行高、字间距和边距references/typographic-rhythm.md— 比例计算、行高等级、间距规则references/pairing-principles.md— 对比理论、决策树、超级字族
模式
MCP 提示: 如果已连接 google-fonts MCP 服务,请优先使用其工具——
search_fonts、generate_typography_system、lookup_font、list_scales、list_pairings——
而不是下面的脚本。对于仅安装技能的情况,脚本可作为后备方案。
单字体(严格)
标题和正文使用同一种字体。字重范围必须涵盖 400+700。必须适用于正文。
python3 scripts/search.py "modern clean SaaS" --mode single
python3 scripts/search.py "geometric professional" --mode single --tier A
字体配对(对比)
使用两种具有字体排印对比的字体。优先搜索经过验证的配对。
python3 scripts/search.py "elegant editorial luxury" --mode pair
python3 scripts/search.py "tech startup bold" --mode pair
查询与比例
python3 scripts/search.py "Inter" --mode lookup # full metadata for a named font
python3 scripts/search.py "marketing bold" --mode scale # search type scales
完整系统输出
根据字体选择和比例选择,生成 CSS + Tailwind + 嵌入链接。
# Single font
python3 scripts/generate-css.py --font "Inter" --scale major-third --format all
# Font pair
python3 scripts/generate-css.py --heading "Playfair Display" --body "Inter" \
--scale perfect-fourth --format all
# Custom weights and base size
python3 scripts/generate-css.py --heading "Space Grotesk" --body "DM Sans" \
--heading-weights "400;700" --body-weights "300;400;500;700" \
--scale minor-third --base 16 --format css
工作流
- 了解背景 — 询问:产品类型、风格、内容密度、现有品牌
- 搜索字体 — 使用相关关键词和模式运行 search.py
- 展示前 3 个结果 — 显示 Family、Personality、Contrast、Quality Tier、Weight Range
- 生成系统 — 使用所选字体和适当的比例运行 generate-css.py
- 交付 — 提供 CSS 自定义属性、Tailwind 配置和嵌入链接
快速决策指南
| 项目类型 | 模式 | 比例 | 建议搜索词 |
|---|---|---|---|
| SaaS / 仪表板 | single | major-second | "clean professional geometric" |
| 博客 / 内容 | pair | major-third | "editorial readable" |
| 营销 / 落地页 | pair | perfect-fourth | "bold modern confident" |
| 奢侈品 / 时尚 | pair | augmented-fourth | "elegant premium serif" |
| 文档 | single | minor-third | "readable accessible humanist" |
| 电商 | pair | minor-third | "clean friendly conversion" |
| 作品集 | pair | perfect-fourth | "creative distinctive" |
| 企业 / 政府 | single | major-second | "trustworthy accessible corporate" |
比例参考
| 比例 | 比率 | 适用场景 |
|---|---|---|
| minor-second | 1.067 | 密集型 UI、仪表板 |
| major-second | 1.125 | 应用、管理面板 |
| minor-third | 1.2 | 通用场景 |
| major-third | 1.25 | 博客、内容 |
| perfect-fourth | 1.333 | 营销、编辑内容 |
| augmented-fourth | 1.414 | 杂志、表现力强的设计 |
| perfect-fifth | 1.5 | 大量使用展示字体的设计 |
| golden-ratio | 1.618 | 主视觉区域 |
字体配对对比类型
- 结构:衬线 + 无衬线(最稳妥,对比度最高)
- 比例:几何无衬线 + 人文主义无衬线(微妙、现代)
- 时代:旧式衬线 + 新哥特式无衬线(戏剧性强)
- 字重:同一字体家族,使用不同字重(最简单)
质量规则
- 在 Google Fonts 嵌入代码中始终使用
display=swap - 优先使用可变字体(减少 HTTP 请求,支持完整的字重灵活性)
- 绝不建议将单一字重的字体用于正文
- 建议字体前,先确认 Weight_Range 涵盖所需字重
- 正文字体:仅建议 Body_Suitable=="Yes" 的字体
- 优先推荐 A 级字体,其次是 B 级,再次是 C 级
- 为 fonts.googleapis.com 和 fonts.gstatic.com 添加
preconnect提示 - 每个项目最多使用 3 个字体系列(标题 + 正文 + 可选等宽字体)
- css2 URL 使用分号分隔字重(
wght@400;700),使用..表示范围([email protected]); 逗号会被规范化,但格式错误的轴和连字符范围会被拒绝
输出内容
- CSS 自定义属性:字体系列、字号、行高、字间距、行长
- Tailwind 配置:fontFamily、包含 lineHeight 和 letterSpacing 的 fontSize
- 带有 preconnect 的 Google Fonts
<link>嵌入代码 - 响应式断点指南
示例库
100 套应用于虚构项目的预制排版系统。可浏览 showcase/index.html,
也可通过 showcase/showcase.json 进行程序化访问。
当用户说“给我看看示例”“帮我选一种风格”或“什么风格适合 SaaS 应用”时,
读取 showcase/showcase.json 并按项目类型筛选,推荐预制系统。
重新生成
python3 scripts/generate-showcase.py
如需了解详细的排版理论,请阅读 references/typographic-rhythm.md。
如需查看字体搭配决策树,请阅读 references/pairing-principles.md。