开发工具CLI【免费下载链接】nerd-fontsIconic font aggregator, collection, patcher. 3,600 icons, 50 patched fonts: Hack, Source Code Pro, more. Glyph collections: Font Awesome, Material Design Icons, Octicons, more项目地址https://gitcode.com/GitHub_Trending/ne/nerd-fonts点击查看免费下载导读本文以 src/svgs/README.md 为骨架深入解析 Nerd Fonts 仓库中 Seti-UI Original 图标集的源文件组织方式、命名约定以及两条自动化流水线由单个 SVG 生成补丁用字体的generate-original-source.py和每次推送时自动执行的 Inkscape 路径简化optimize-original-source.sh。读完本文你将掌握 SVG 源文件与 codepoint 注册表的协作机制、_nf后缀的命名规则、别名机制的用法以及如何把新增图标接入 CI 自动化流程。Seti-UI Original 图标源文件概览src/svgs/ 目录存放的是 Nerd Fonts 中Seti-UI OriginalSeti 与原创图标集的全部源字形source glyphs。目录中既有沿袭自 Seti-UI 的经典图标如python.svg、javascript.svg、git.svg也有 Nerd Fonts 自创的 Original 系列图标。该目录包含 194 个 SVG 源文件辅以 17 个以.sv_结尾的停用变体文件以及一份核心的icons.tsv注册表。整个目录的产物最终被generate-original-source.py打包成 src/glyphs/original-source.otf 这一补丁用字体。命名约定_nf后缀的作用为了与 Seti 图标的文件名严格区分所有 Original原创系列文件都带有_nf后缀避免与 Seti 同名文件混淆。从 icons.tsv 中可以观察到这一约定在实践中的体现Original 系列带_nf对应 Seti 系列go_nf.svgi_custom_gogo.svgi_seti_goc_nf.svgi_custom_cc.svgi_seti_ccpp_nf.svgi_custom_cppcpp.svgi_seti_cppruby_nf.svgi_custom_rubyruby.sv_elixir_nf.svgi_custom_elixirelixir.sv_注意目录中存在ruby.sv_、elixir.sv_、elm.sv_、purescript.sv_、kotlin.sv_等以.sv_结尾的文件——这些是已停用/未启用的 SVG 变体它们不会被generate-original-source.py处理脚本只扫描icons.tsv中登记的文件名实际生效的图标都以_nf后缀的版本为准。目录中还保留了cjsx.sv_、git_ignore.sv_等一批.sv_文件它们代表旧版或弃用的来源提醒读者不要将其误认为有效源文件。_nf后缀的另一个作用是将代码点命名空间区分开icons.tsv中i_seti_*前缀对应 Seti 图标i_custom_*前缀对应 Nerd Fonts 原创图标。两者可以指向同一 codepoint 而互不冲突见下文别名机制。icons.tsvcodepoint 注册表README 明确指出这里的图标的 codepoint 和名称必须写入icons.tsv。这份 icons.tsv 是连接 SVG 文件与字体字形的唯一事实来源共登记 194 个图标与 21 个别名见 bin/scripts/lib/i_seti.sh 的自动生成头注释。格式规范每行由 tab 分隔的 2~3 个字段构成文件顶部还有明确的维护守则# offset name (in i_seti.sh) filename (.svg) 000 i_custom_folder_npm npm-folder_nf.svgoffset相对起始码点0xE4FA的偏移量必须为整数且非负name在i_seti.sh、CSS 和 cheat sheet 中使用的图标名称只允许[a-zA-Z0-9_]字符含下划线则自动替换filenamesrc/svgs/下的 SVG 文件名别名行省略该字段#开头的行是注释被解析器跳过。关键约束README 与 icons.tsv 都强调了Keep the numbers consecutive偏移量必须连续。这一点由generate-original-source.py的hasGaps()函数强制检查它遍历start_codepoint 1到max之间的所有码点一旦发现缺失就打印Gap at offset ...警告。别名机制一行 SVG 对应多个名字从icons.tsv可以看到成熟的别名复用模式——同一 offset 的后续行只写 name省略 filename即可为一个 SVG 提供多个名称008 i_custom_play_arrow play-arrow_nf.svg 008 i_seti_play_arrow这里i_seti_play_arrow就是i_custom_play_arrow的别名。类似的还有001 i_custom_folder_git→i_custom_folder_git_branch028 i_seti_npm→i_seti_npm_ignored099 i_seti_git→i_seti_git_folder/i_seti_git_ignore039 i_indent_line→i_indentation_line/i_indent_dotted_guide084 i_seti_default→i_seti_textaddLineToData()是别名处理的核心逻辑若某 codepoint 已存在则向该条目追加 name记为 alias若别名行还带了不同的 filename会打印Conflicting filename ... ignoring并拒绝。所有别名最终都会写入i_seti.sh例如生成结果中i_custom_folder_git_branch$i_custom_folder_git指向同一个字形。generate-original-source.pySVG 到字体的一站式生成README 说明generate-original-source.py从所有这些独立字形生成一个字体文件该字体随后被用于实际打补丁过程。脚本源码位于 bin/scripts/generate-original-source.py是这条流水线的发动机。码点分配策略脚本顶部的常量定义了关键布局start_codepoint 0xE4FA # with shift this is 0xE5FA end_codepoint 0xE5FF # Next set starts at 0xE700 - 0x0100 shift 0xE600 codepoint_shift 0x0100 # shift introduced by font-patcherSeti 图标集在PUAPrivate Use Area私有使用区中占用0xE4FA–0xE5FF共 262 个可用位置当前用了 194 个。codepoint_shift 0x0100表示font-patcher打补丁时会统一上移 2560x100把字形放到0xE5FA–0xE6FF区间。这一设计在 font-patcher 的图标集定义中得到了印证{Enabled: basics_enabled, Name: Seti-UI NerdFonts, Filename: original-source.otf, Exact: False, SymStart: 0xE4FA, SymEnd: 0xE5FF, SrcStart: 0xE5FA, ... ish: i_seti.sh}解析与校验流程readIconFile()按行解析icons.tsv校验逻辑包括注释行#开头直接跳过字段数必须是 2 或 3否则打印Unexpected data on the lineoffset 必须为正否则打印Offset must be positive并忽略name 中的非法字符非[a-zA-Z0-9_]替换为_。每读入一行codepoint start_codepoint offset随后调用addLineToData()登记含别名合并。完成后打印Read glyph data successfully with N entries (M aliases)。字形归一化缩放、居中与宽度addIcon()负责把每个 SVG 导入 FontForge 并统一规格其目标边界框dBB [53, 0, 1000 - 53, 900]即约[53, 0, 947, 900]scale scale_y if scale_y scale_x else scale_x # 等比缩放取较小比例防溢出 glyph.transform(psMat.scale(scale, scale)) # 先等比缩放 glyph.transform(psMat.translate( # 再平移居中 calcShift(dBB[0], widthFromBB(dBB), gBB[0], widthFromBB(gBB)), calcShift(dBB[1], heightFromBB(dBB), gBB[1], heightFromBB(gBB)))) glyph.width int(dBB[2] dBB[0]) # 设置统一字宽 1000即等比缩放以较小比例为准→ 计算平移量使其在目标框内居中 → 统一字宽为 1000 单位。字体本身采用em 1024、UnicodeFull编码并额外创建宽度 200 的空格字形U0020以避免 IE11 显示未知字符方框。范围越界保护脚本对码点范围有硬性保护若任何图标超出start_codepoint..end_codepoint区间会打印FATAL: We are leaving the allocated codepoint range ... bailing out并exit(1)终止防止破坏与其他图标集如 Devicons 从0xE600起的 PUA 分配边界。输出产物src/glyphs/original-source.otf用于实际打补丁的字体文件生成时带no-FFTM-table标志bin/scripts/lib/i_seti.sh自动生成的 bash 变量文件供 cheat sheet、CSS 生成等场景使用。生成时所有 codepoint 都会加上0x0100的 shifticon_datasets { code codepoint_shift : ... }因此头注释显示Codepoints: E5FA-E6BB与字体中实际落点的 PUA 位置一致。变量形式如i i_seti_stylus$ioptimize-original-source.sh推送时的自动路径简化README 警告如果你在这里推送一个新的 svg 文件它会被运行 Inkscape 的 simplify-path 处理且每次推送都会通过optimize-original-source.sh自动执行简化。脚本位于 bin/scripts/optimize-original-source.sh。工作流程与保护机制脚本遍历src/svgs下所有*.svg对每个文件执行inkscape $s --actionsselect-all;object-simplify-path;export-filename:temp.svg;export-do;quit-inkscape即 Inkscape 命令行下全选 → 简化路径 → 导出临时文件。随后比较新旧文件大小只有满足**新文件体积 ≤ 原文件体积的 80%**size_ratio_max80时才真正替换原文件否则保留原图——这是防止简化后反而膨胀的守护条件。dry-run 模式脚本支持演练参数不带参数运行时为 dry run只报告可能被简化的文件不实际修改传入doit才会真正覆盖文件./bin/scripts/optimize-original-source.sh # dry run仅预览 ./bin/scripts/optimize-original-source.sh doit # 实际执行简化脚本默认输出Found N svgs in ../../src/svgs与Found N svgs to simplify两类统计便于 CI 日志审计。对贡献者的实践含义这意味着贡献者不需要手工用 Inkscape 优化 SVG 路径——本地 push 后 CI 会自动完成。但要注意两点简化是针对*.svg的.sv_停用文件不受影响若简化后的结果体积仍在原文件的 80% 以上脚本会跳过该文件即未显著减小则不破坏原路径精度。新增一个图标完整操作路径综合 README、icons.tsv与两个脚本向 Seti-UI Original 图标集贡献一个新图标的完整流程是放置 SVG 源文件到 src/svgs/Original 系列文件名必须带_nf后缀如mylang_nf.svg避免与 Seti 混淆在 icons.tsv 末尾追加注册行offset 必须接续现有最大值当前到193name 使用i_custom_*或i_seti_*前缀格式为offsetTABnameTABfilename.svg如需别名则再追加一行同名 offset、省略 filename 的行提交并推送CI 会自动运行generate-original-source.py重新生成 src/glyphs/original-source.otf 与 bin/scripts/lib/i_seti.sh并通过optimize-original-source.sh对新增 SVG 做路径简化验证连续性确保 offset 无跳号否则hasGaps()会输出Gap at offset ...告警确保码点不越过0xE5FF否则脚本 FATAL 退出。生成的i_seti.sh变量可直接在 shell 中引用如echo $i_seti_python输出对应 PUA 字符CSS 侧则由css/nerd-fonts-generated.css等文件消费这些名称构成从 SVG → OTF → CSS/cheat sheet 的完整链路。小结src/svgs/ 是 Seti-UI Original 图标集的源字形目录Original 系列以_nf后缀与 Seti 文件区分icons.tsv 是 codepoint/名称/文件的唯一注册表offset 必须连续别名通过省略 filename 的重复行实现bin/scripts/generate-original-source.py 用 FontForge 将全部 SVG 归一化等比缩放、居中、统一字宽生成 src/glyphs/original-source.otf并附带码点越界保护与缺口检测bin/scripts/optimize-original-source.sh 在每次推送时用 Inkscape 自动简化 SVG 路径以 dry-run /doit双模式保证可控性新增图标只需放 SVG 注册 tsv 推送字体生成与路径优化全部由 CI 自动化接管这也是 Nerd Fonts 图标集能长期稳定扩展的工程基础。赞分享开发工具CLI【免费下载链接】nerd-fontsIconic font aggregator, collection, patcher. 3,600 icons, 50 patched fonts: Hack, Source Code Pro, more. Glyph collections: Font Awesome, Material Design Icons, Octicons, more项目地址https://gitcode.com/GitHub_Trending/ne/nerd-fonts点击查看免费下载相关推荐Gopeed 文件分类图标体系从 SVG 源物料到 Flutter IconFont 的确定性流水线Gopeed 文件分类图标体系从 SVG 源物料到 Flutter IconFont 的确定性流水线 导读 Gopeed 是一款基于 Go 与 Flutter网络CLI后端Nerd Fonts图标质量评估体系Nerd Fonts图标质量评估体系 Nerd Fonts作为开发者字体增强项目通过整合Font Awesome、Devicons等多种图标集为编程环境提供开发工具CLINerd Fonts在CI/CD流水线中的集成Nerd Fonts在CI/CD流水线中的集成 你是否还在为本地开发环境与CI/CD流水线中字体不一致导致的构建错误、日志乱码或UI测试失败而困扰本文将详细介开发工具CLI上一篇Caelestia Shell 终极指南5分钟快速安装与完美配置教程下一篇Sigma File Manager笔记编辑器内置Markdown支持的强大工具完全指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考