【免费下载链接】usageA specification for CLIs项目地址https://gitcode.com/gh_mirrors/usage/usage点击查看免费下载Usage是一个 Rust CLI 框架你用#[derive(Cli)]声明命令它为你生成类型化解析器还能同步导出 KDL 规格、帮助、补全和文档。更关键的是它的体积优势——在同一个 211 条命令的基准上链接 Usage 的解析二进制只有1.3 MB而 clap 版本需要3.1 MB足足小了近一半。秘诀就在于「静态解析表」这套设计。先看懂 3.1MB 是从哪来的 传统做法比如 clap的工作方式是程序启动时在运行时构建整棵命令树再验证它最后才真正开始解析你敲下的命令行。这意味着框架里携带了一整套运行时搭建解析器的机器树构建器、校验逻辑、错误提示、建议系统等全部编进二进制。以 mise 规模的命令树为例clap 的 544 µs 解析时间里约 343 µs 花在构建树上178 µs 花在验证上真正解析只占 23 µs——体积和时间的成本都在运行时搭架子。核心方案编译期生成静态解析表 ⚙️Usage 把这份昂贵的成本挪到了编译期。它的 derive 宏在编译你的应用时把命令树变成三样东西见 derive/src/codegen.rs 开头的设计说明静态解析表staticCommand、Flag、Arg的布局被编译器直接放进二进制成功解析只读这些表静态元数据帮助文本、规格、补全等冷数据与解析表分离成功解析时根本不会触碰它们一个match式的parse函数按表的整数索引直接写入结构体字段——没有 map、没有中间值、没有多余分配。运行时发生的事情就只剩查表 赋值读一遍 argv、在当前命令的 flag 里查找而不是全量 722 个 flag、用生成的整数键定位目标字段。命令栈是定长数组一次裸解析甚至零堆分配。体积数据同一工作区、同样规模的三方对比 基准gate用同一份 mise.usage.kdl 规格生成三个框架的影子实现211 条命令、722 个 flag、4 层子命令同一工作区 release 构建、strip 后测量来源见 docs/rust/performance.md框架二进制体积解析指令数解析耗时分配次数未绑定值时usage1.3 MB7,3770.7 µs0bpaf2.5 MB21.9M1,610 µs—clap3.1 MB6.31M544 µs6,560注意体积的构成Usage 的运行时 crate 本身编译后仅约16 KB解析器的占位几乎全是每个命令的绑定代码 静态表mise 规模下约 150 KB。换句话说体积跟随你声明了多少命令和字段而不是你开启了哪些功能。还能更小两条 Cargo 配置再省一截 任何 CLI 都可以叠加两个与框架无关的 release 优化strip true移除符号和调试信息上表数据已默认开启panic abort去掉 unwinding 着陆垫与 backtrace 机制在 mise 规模上再省 84 KB约 −6%。代码与数据在哪里看 设计说明与全部基准数据docs/rust/performance.md静态表生成器derive 代码生成核心derive/src/codegen.rs三方对比基准 gatebenches/gate/Cargo.toml生成的影子实现mise/clap/bpaf 等benches/shadows/真实 CLI 迁移探测fd、starship、tokeibenches/external/README.mdRust 框架文档入口docs/rust/index.md小结Usage 用编译期生成静态解析表 运行时只查表的策略把 CLI 解析器从 3.1 MB 压到 1.3 MB同时把解析耗时从数百微秒降到 0.7 微秒、零分配。如果你也在意二进制的分发体积和启动速度这套成本前置到编译期的思路值得一看。赞分享【免费下载链接】usageA specification for CLIs项目地址https://gitcode.com/gh_mirrors/usage/usage点击查看免费下载相关推荐Boss Show Time终极指南5个技巧精准掌握招聘发布时间提升求职成功率Boss Show Time终极指南5个技巧精准掌握招聘发布时间提升求职成功率 还在为无法判断招聘职位的发布时间而错过最佳投递时机吗Boss Show T前端极致压缩TinyGo二进制体积优化实战指南极致压缩TinyGo二进制体积优化实战指南 你还在为嵌入式设备的存储空间不足而烦恼吗当标准Go编译的二进制文件动辄几MB而你的微控制器只有几百KB闪存时编译器嵌入式语言运行时WebAssemblyDeep Agents UI部署完全指南Next.js应用上线最佳实践Deep Agents UI部署完全指南Next.js应用上线最佳实践 Deep Agents UI是基于Next.js构建的自定义用户界面专为Deep A前端AI 应用交互助手上一篇3步解锁智能课本解析工具让离线学习效率翻倍的秘密下一篇Headlamp Job 类解析K8s Job 资源对象如何驱动 Web UI 的列表与详情页创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/10/16 1:29:16 · 阅读 1.2k 从 3.1MB 到 1.3MB：Usage 如何用静态解析表压缩 CLI 二进制体积
【免费下载链接】usageA specification for CLIs项目地址https://gitcode.com/gh_mirrors/usage/usage点击查看免费下载Usage是一个 Rust CLI 框架你用#[derive(Cli)]声明命令它为你生成类型化解析器还能同步导出 KDL 规格、帮助、补全和文档。更关键的是它的体积优势——在同一个 211 条命令的基准上链接 Usage 的解析二进制只有1.3 MB而 clap 版本需要3.1 MB足足小了近一半。秘诀就在于「静态解析表」这套设计。先看懂 3.1MB 是从哪来的 传统做法比如 clap的工作方式是程序启动时在运行时构建整棵命令树再验证它最后才真正开始解析你敲下的命令行。这意味着框架里携带了一整套运行时搭建解析器的机器树构建器、校验逻辑、错误提示、建议系统等全部编进二进制。以 mise 规模的命令树为例clap 的 544 µs 解析时间里约 343 µs 花在构建树上178 µs 花在验证上真正解析只占 23 µs——体积和时间的成本都在运行时搭架子。核心方案编译期生成静态解析表 ⚙️Usage 把这份昂贵的成本挪到了编译期。它的 derive 宏在编译你的应用时把命令树变成三样东西见 derive/src/codegen.rs 开头的设计说明静态解析表staticCommand、Flag、Arg的布局被编译器直接放进二进制成功解析只读这些表静态元数据帮助文本、规格、补全等冷数据与解析表分离成功解析时根本不会触碰它们一个match式的parse函数按表的整数索引直接写入结构体字段——没有 map、没有中间值、没有多余分配。运行时发生的事情就只剩查表 赋值读一遍 argv、在当前命令的 flag 里查找而不是全量 722 个 flag、用生成的整数键定位目标字段。命令栈是定长数组一次裸解析甚至零堆分配。体积数据同一工作区、同样规模的三方对比 基准gate用同一份 mise.usage.kdl 规格生成三个框架的影子实现211 条命令、722 个 flag、4 层子命令同一工作区 release 构建、strip 后测量来源见 docs/rust/performance.md框架二进制体积解析指令数解析耗时分配次数未绑定值时usage1.3 MB7,3770.7 µs0bpaf2.5 MB21.9M1,610 µs—clap3.1 MB6.31M544 µs6,560注意体积的构成Usage 的运行时 crate 本身编译后仅约16 KB解析器的占位几乎全是每个命令的绑定代码 静态表mise 规模下约 150 KB。换句话说体积跟随你声明了多少命令和字段而不是你开启了哪些功能。还能更小两条 Cargo 配置再省一截 任何 CLI 都可以叠加两个与框架无关的 release 优化strip true移除符号和调试信息上表数据已默认开启panic abort去掉 unwinding 着陆垫与 backtrace 机制在 mise 规模上再省 84 KB约 −6%。代码与数据在哪里看 设计说明与全部基准数据docs/rust/performance.md静态表生成器derive 代码生成核心derive/src/codegen.rs三方对比基准 gatebenches/gate/Cargo.toml生成的影子实现mise/clap/bpaf 等benches/shadows/真实 CLI 迁移探测fd、starship、tokeibenches/external/README.mdRust 框架文档入口docs/rust/index.md小结Usage 用编译期生成静态解析表 运行时只查表的策略把 CLI 解析器从 3.1 MB 压到 1.3 MB同时把解析耗时从数百微秒降到 0.7 微秒、零分配。如果你也在意二进制的分发体积和启动速度这套成本前置到编译期的思路值得一看。赞分享【免费下载链接】usageA specification for CLIs项目地址https://gitcode.com/gh_mirrors/usage/usage点击查看免费下载相关推荐Boss Show Time终极指南5个技巧精准掌握招聘发布时间提升求职成功率Boss Show Time终极指南5个技巧精准掌握招聘发布时间提升求职成功率 还在为无法判断招聘职位的发布时间而错过最佳投递时机吗Boss Show T前端极致压缩TinyGo二进制体积优化实战指南极致压缩TinyGo二进制体积优化实战指南 你还在为嵌入式设备的存储空间不足而烦恼吗当标准Go编译的二进制文件动辄几MB而你的微控制器只有几百KB闪存时编译器嵌入式语言运行时WebAssemblyDeep Agents UI部署完全指南Next.js应用上线最佳实践Deep Agents UI部署完全指南Next.js应用上线最佳实践 Deep Agents UI是基于Next.js构建的自定义用户界面专为Deep A前端AI 应用交互助手上一篇3步解锁智能课本解析工具让离线学习效率翻倍的秘密下一篇Headlamp Job 类解析K8s Job 资源对象如何驱动 Web UI 的列表与详情页创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考