如何实现带多子命令结构的Clojure CLI应用

适配需求的依赖包推荐 #

别用网上老教程提的tools.cli，那个库本身只支持单层级flag解析，要做子命令得自己写路由、手动切分参数段，对新手来说很容易出边界bug，直接选下面两个成熟库就行，都是原生支持你要的全局flag + 子命令 + 子命令自有flag/位置参数结构的：

• 首推cli-matic：这个库就是专门做多子命令CLI工具的，你要的调用格式它原生支持，不需要自己写额外的参数切分逻辑。配置完全局参数、每个子命令的参数规则之后，它会自动帮你做参数解析、类型校验、默认值填充，还能自动生成标准的--help帮助文本，甚至子命令输错的时候还会提示相近的命令名，对新手非常友好，基本不用踩解析逻辑的坑。
• 如果你后续想要更快的启动速度，打算把工具打包成单二进制，可以选babashka.cli，这个库是轻量实现，依赖极少，解析速度快，同样原生支持嵌套子命令，缺点是自动生成帮助文档、参数错误提示的能力比cli-matic弱一点，需要自己补几行辅助逻辑。

项目结构搭建参考 #

你已经有现成的爬取工具库了，不用搞太复杂的架构，按下面的最小可用结构搭就行，后续扩展也方便：

cljscrape/
├── deps.edn                ;; Clojure官方依赖配置文件，所有第三方依赖都在这里声明
├── src/cljscrape/
│   ├── core.clj            ;; 程序入口，只负责全局参数解析、子命令路由转发
│   ├── collect.clj         ;; collect子命令逻辑，直接对接你之前写的爬取库就行
│   ├── browse.clj          ;; browse子命令逻辑，处理历史采集数据的读取、格式化输出
│   ├── search_config.clj   ;; search-config子命令逻辑，处理搜索参数的增删、持久化
│   └── common.clj          ;; 放通用方法，比如配置文件读写、控制台输出格式化这类
└── test/                   ;; 单元测试目录，初期功能简单可以先留空

几个实现时的注意点，都是新手容易踩的：

• 入口文件core.clj别塞业务逻辑，就干三件事：第一解析最靠前的全局通用flag（比如--verbose调试开关、--data-dir数据存储路径这类所有子命令都可能用到的参数）；第二识别第一个非flag参数作为子命令名，匹配到对应子命令的处理函数；第三把剩下的所有参数传给对应子命令的处理函数就行。路由逻辑写个map映射就够，比如{"collect" collect/run "browse" browse/run "search-config" search-config/run}，后续加新子命令只要在这个map里加一行，不用改核心逻辑。
• 每个子命令自己的参数定义、校验逻辑全写在对应的业务文件里，不要全堆在入口，不然后续改参数的时候找起来很麻烦。
• 开发阶段不用急着打包，直接用clj -M -m cljscrape.core [你的命令参数]就能跑调试，等功能全测通了再打成独立uberjar，或者用graalvm编译成原生二进制，启动速度会快很多。

小提示：刚开始写的时候不用追求参数校验做的面面俱到，先把三个子命令的路由跑通，能正常调用你之前写的库，再慢慢补参数校验、错误提示，cli-matic自带的校验能力足够覆盖90%以上的场景，不用自己手写一堆判断逻辑。

内容的提问来源于stack exchange，提问作者jgeedev