539 字
3 分钟
为 Fuwari 博客更换个性化字体:以 MiSans 为例

本文面向 Fuwari 用户,演示如何引入第三方字体 MiSans,包含 @font-faceTailwind 配置。


前言#

字体修改参考了《对 Fuwari 进行一些小的改动》by 伊卡,特此致谢。

本教程选择 MiSans 作为示例字体:

MiSans 是小米主导、联合蒙纳字库与汉仪字库打造的全球语言字体家族,覆盖 20+ 书写系统、600+ 语言、10 万+ 字符,强调 简约 / 清晰 / 易读 的统一视觉体验。

官方站点:https://hyperos.mi.com/font/zh/


准备工作#

请先下载 MiSans 并准备以下两个字重(可替换为你需要的任意字重):

  • MiSans-Normal.woff2(400)
  • MiSans-Semibold.woff2(700)

然后将字体文件放到:

public/fonts/

目录结构示例:

public/
fonts/
MiSans-Normal.woff2
MiSans-Semibold.woff2

小提示:如果你的字体文件名不同,请记得后续同步修改路径。


步骤一:在 main.css 中注册字体#

打开 src/styles/main.css,在文件顶部添加 @font-face

@font-face {
font-family: 'MiSans';
src: url('/fonts/MiSans-Normal.woff2') format('woff2');
font-weight: 400;
font-style: normal;
font-display: swap;
}
@font-face {
font-family: 'MiSans';
src: url('/fonts/MiSans-Semibold.woff2') format('woff2');
font-weight: 700;
font-style: normal;
font-display: swap;
}

font-display: swap 可以避免字体加载期间的闪烁,提高首屏体验。


步骤二:在 Tailwind 中设为默认字体#

打开 tailwind.config.cjs,将 fontFamily.sans 改为:

/** @type {import('tailwindcss').Config} */
const defaultTheme = require("tailwindcss/defaultTheme")
module.exports = {
content: ["./src/**/*.{astro,html,js,jsx,md,mdx,svelte,ts,tsx,vue,mjs}"],
darkMode: "class", // allows toggling dark mode manually
theme: {
extend: {
fontFamily: {
sans: ["MiSans", ...defaultTheme.fontFamily.sans],
},
},
},
plugins: [require("@tailwindcss/typography")],
}

注意:不要重复声明 sans,保留一个即可。


验证效果#

运行开发服务器:

Terminal window
pnpm dev

如果一切正常,你会看到站点的默认文字已替换为 MiSans


常见问题#

Q1:字体没有生效?

  • 确认字体文件路径是否正确(区分大小写)。
  • 确认浏览器没有缓存旧资源(强制刷新)。

Q2:我想只在正文生效?

  • 你可以在正文容器上单独添加 font-family: 'MiSans',不要改 Tailwind 默认字体。

小结#

通过两步即可完成全站字体替换:

  1. main.css 注册字体
  2. tailwind.config.cjs 设置默认字体

如果你也希望站点风格更统一,换上自己喜欢的字体会是最简单有效的提升方式。

本文示例字体为 MiSans,版权归原作者所有,仅作教学演示。

为 Fuwari 博客更换个性化字体:以 MiSans 为例
https://fuwari.vercel.app/posts/fuwari-custom-font-misans/
作者
Alumos
发布于
2026-02-03
许可协议
CC BY-NC-SA 4.0