在 node.js cli 工具中，用 commonjs 管理子命令模块的核心思路是：每个子命令封装为独立模块，主入口通过 require() 动态加载并统一注册到命令解析器；子命令模块导出配置对象或函数，主文件用 fs.readdirsync 扫描目录、同步 require 加载，利用 commonjs 缓存机制确保单例与初始化安全，并通过 package.json 的 bin 字段和 shebang 规范实现可执行 cli。

在 Node.js 编写的 CLI 工具中，用 CommonJS 管理子命令模块的核心思路是：**每个子命令封装为独立模块，主入口通过 require() 动态加载，再统一注册到命令解析器（如 Commander 或自定义路由）中**。这种方式保持结构清晰、职责分离，也便于测试和复用。

子命令模块按文件组织

把每个子命令写成单独的 CommonJS 模块（如 cmd/deploy.js、cmd/init.js），导出一个配置对象或函数：

• 导出对象（推荐）：包含 command 字符串、description、builder（参数定义）和 handler（执行逻辑）
• 导出函数：接收 program 实例，内部调用 program.command().description().action()

例如 cmd/build.js：

module.exports = {
  command: 'build [target]',
  description: 'Build project for specified target',
  builder: (yargs) => yargs
    .option('watch', { type: 'boolean', default: false }),
  handler: async (argv) => {
    console.log(`Building ${argv.target || 'all'}...`);
  }
};

主 CLI 入口统一加载子命令

在主文件（如 bin/cli.js）中，用 fs.readdirSync 扫描 cmd/ 目录，遍历并 require() 每个子命令模块：

• 确保只加载 .js 文件，跳过 .d.ts 或临时文件
• 使用 path.join(__dirname, '../cmd', file) 构造正确路径
• 对每个模块调用 program.command(...).action(...) 注册

注意：CommonJS 的同步加载特性让这种动态注册天然可靠，无需等待 Promise。

Zenlink - Node SDK for ZenHeart

ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。

下载

利用模块缓存避免重复加载

Node.js 对相同路径的 require() 自动缓存结果。即使多个地方 require 同一子命令模块，也只执行一次初始化逻辑 —— 这对带副作用的配置（如日志初始化、环境检查）很关键。

• 如果子命令模块里有全局状态（如连接池、配置实例），缓存机制能保证单例行为
• 调试时可通过 require.cache 查看已加载模块，或手动 delete require.cache[modulePath] 强制重载（仅开发用）

配合 package.json 的 bin 字段与入口规范

在 package.json 中声明 CLI 名称和入口：

"bin": {
  "mycli": "./bin/cli.js"
},

确保 ./bin/cli.js 顶部有 Unix shebang：#!/usr/bin/env node，并设为可执行权限（chmod +x bin/cli.js）。这样安装后就能直接运行 mycli build。

子命令模块本身不需导出 main，也不参与 npm 发布逻辑 —— 它们只是内部实现细节，由主 CLI 控制生命周期。

Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南