霞鹜文楷字体配置指南：3 步把 LXGW WenKai 装进 VSCode 和终端
【免费下载链接】LxgwWenKaiAn open-source Chinese font derived from Fontworks' Klee One. 一款开源中文字体，基于 FONTWORKS 出品字体 Klee One 衍生。项目地址: https://gitcode.com/GitHub_Trending/lx/LxgwWenKai
还在用编辑器默认字体写中文注释？装完字体却显示不生效？LXGW WenKai（霞鹜文楷）是一款基于 Klee One 衍生的开源中文字体，SIL OFL 1.1 协议下个人、企业均可免费商用。它带有等宽版本 LXGW WenKai Mono，中文注释、终端输出与英文代码能保持整齐对齐，2 个 TTF 文件就能完成安装。
先看效果
下图是霞鹜文楷增补简体汉字后的实际渲染效果，蓝色为增补字、绿色为调整过的字形，可以看到楷书写意风格与等宽排版并不冲突：
配置完成后，中文注释会以楷体风格显示，且中英混排不错位。下面按「选版本 → 安装 → 配置」的顺序走一遍，全程大约 10 分钟。
选对版本再动手
仓库fonts/TTF目录下共有 6 个 TTF 文件，分常规版（非等宽）和 Mono 版（等宽）两个家族，每个家族 3 个字重。动手前先对号入座：
| 使用场景 | 推荐文件 | 理由 |
|---|---|---|
| 日常写代码 | LXGWWenKaiMono-Regular.ttf | 等宽对齐 + Regular 字重，密度和清晰度平衡 |
| 长时间阅读代码 | LXGWWenKaiMono-Light.ttf | 笔画更细，降低视觉疲劳 |
| 高分辨率大屏 | LXGWWenKaiMono-Medium.ttf | 笔画加粗，小字号下不易发虚 |
| 中文文档 / 博客 | LXGWWenKai-Regular.ttf | 非常规比例，排版更有书写感 |
一个实用搭配：Mono 版装进编辑器，常规版留给文档类软件，两个文件各 1 份即可，不用全装。
三步跑起来：获取 → 安装 → 验证
字体源文件在仓库 fonts/TTF 目录 下，也可以直接 clone 整个仓库：
git clone https://gitcode.com/GitHub_Trending/lx/LxgwWenKaiWindows 安装字体
- 从 clone 下来的仓库中复制
LXGWWenKaiMono-Regular.ttf（需要哪个字重就复制哪个） - 右键字体文件 → 「安装」，或全选后选「为所有用户安装」
macOS 安装字体
brew install font-lxgw-wenkai # 一键安装全部字重没有 Homebrew 的话，直接双击 TTF 文件，在「字体册」中点「安装字体」。
Linux 安装字体
# 复制等宽版到系统字体目录（路径按发行版调整） sudo cp LXGWWenKaiMono-Regular.ttf /usr/share/fonts/truetype/ fc-cache -fv # 刷新字体缓存，缺了这步编辑器里不会生效30 秒验证是否装好
装完不要急着打开编辑器，先用命令确认字体已被系统识别：
fc-list | grep -i "LXGW" # Linux / macOSGet-ItemProperty 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fonts' | Select-Object PSObject.Properties | Where-Object Value -like '*LXGW*' # Windows只要输出里出现LXGW WenKai Mono，说明安装成功，进入下一步。
按环境配置编辑器与终端
注意：配置里要填的是字体内部名称LXGW WenKai Mono（带空格），不是文件名里的LXGWWenKaiMono，填错就会静默回退到默认字体。
VSCode 配置
settings.json中加 4 行（Ctrl+,打开设置后切到 JSON 视图）：
{ "editor.fontFamily": "LXGW WenKai Mono, Consolas, monospace", // 主字体+兜底 "editor.fontSize": 15, "editor.lineHeight": 1.6, // 楷体偏扁，行高留足 "terminal.integrated.fontFamily": "LXGW WenKai Mono" }改完按Ctrl+Shift+P执行 Reload Window 即可看到效果。
终端配置
- iTerm2（macOS）：Preferences → Profiles → Text → Font 选择
LXGW WenKai Mono - WezTerm / Alacritty：字体字段填
"LXGW WenKai Mono" - Windows Terminal：Settings → 对应配置文件 →
"fontFace": "LXGW WenKai Mono"
终端里中英文、方块符号宽度一致，日志和git diff的对齐就不会再错。
调优与踩坑
值得调的参数
| 参数 | 建议值 | 效果 |
|---|---|---|
editor.fontSize | 14–16 | 楷体笔画细，低于 14 在小屏上会糊 |
editor.lineHeight | 1.5–1.6 | 缓解楷体偏扁导致的行间拥挤 |
editor.letterSpacing | 0.2–0.5 | 字符间距微增，中英混排更透气 |
editor.fontLigatures | false | 等宽字体无连字数据，关掉避免个别符号渲染异常 |
问题速查
1. 现象：编辑器里字体列表有名字，设置后没变化。原因：字体文件只复制了，没让系统注册（Windows 未装到用户目录，或 Linux 没刷新缓存）。解决：重跑fc-cache -fv；Windows 上确认用的是「安装」而不是「为所有用户安装」失败后的残留。
2. 现象：中文正常，英文或数字还是原来的样子，中英宽度对不齐。原因：填成了LXGWWenKaiMono或LXGWWenKaiMono Regular，系统匹配不到真实名称。解决：改成LXGW WenKai Mono（有空格），用前面的fc-list输出核对。
3. 现象：VSCode 设置里字体已改，但终端里不生效。原因：终端字体是独立配置项，不受editor.fontFamily影响。解决：单独配置terminal.integrated.fontFamily。
4. 现象：Linux 上刚装完，fc-list 查不到。原因：复制到了非字体搜索路径，或缓存未刷新。解决：把 TTF 放到/usr/share/fonts/truetype/或~/.local/share/fonts/后再执行fc-cache -fv。
再进一步
- 想嵌入 App 或网页：仓库 README 中提到的「霞鹜文楷 轻便版」剔除了生僻字，体积更小，适合分发
- 想自己改字形：sources 目录 下有 UFO 源文件和
extract_ufoz.py、fix_mono.py等构建脚本，配合 fontmake 可重新打包 - 字形优化、显示问题建议直接到项目仓库的 Issues 里反馈，维护者会统一整理
霞鹜文楷用楷体笔画换来的是中文注释和终端输出不再「方脸」，等宽版让它真正能胜任代码场景。现在可以按上面三步把字体装起来，装完 30 秒就能验证结果；遇到没覆盖到的问题，先跑一遍「问题速查」，再去看 README 和 History 了解版本细节。
【免费下载链接】LxgwWenKaiAn open-source Chinese font derived from Fontworks' Klee One. 一款开源中文字体，基于 FONTWORKS 出品字体 Klee One 衍生。项目地址: https://gitcode.com/GitHub_Trending/lx/LxgwWenKai
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
