Commander.js 完全指南：构建专业 Node.js CLI 工具
Commander.js 是 Node.js 最流行的 CLI 框架。本文讲解命令与选项定义、参数校验、子命令组织、自动帮助生成，以及交互式提示与彩色输出的增强技巧。
Commander.js 用链式 API 定义命令行程序：program.command('名').description().option().action() 四件套组织子命令，program.parse() 解析参数，帮助文档和版本输出自动生成。它处理了参数解析的全部脏活，让你专注业务逻辑。
为什么是 Commander
手写 process.argv 解析是痛苦之源：选项位置、等号/空格两种赋值、-abc 合并短选项、帮助文本生成……Commander 把这一切标准化，npm 周下载量数千万，Vue CLI、create-react-app 等明星项目都用它。
快速开始
npm install commander
#!/usr/bin/env node
const { Command } = require('commander');
const program = new Command();
program
.name('deploy')
.description('部署工具')
.version('1.0.0');
program
.command('push')
.description('推送并部署')
.option('-e, --env <环境>', '目标环境', 'staging')
.option('-f, --force', '跳过确认', false)
.action((options) => {
console.log(`部署到 ${options.env}${options.force ? '（强制）' : ''}`);
});
program.parse();
运行 node deploy.js push -e production --force，--help 和 --version 自动可用。<尖括号> 表示必填选项值，[方括号] 表示可选。
参数处理与校验
- 位置参数：
.command('clone <repo> [dir]')，action 回调按位接收； - 可变参数：
add <files...>收集为数组； - 自定义解析：
.option('-n, --count <数>', '数量', parseInt)——传函数做类型转换； - 必选选项：
.requiredOption('-t, --token <令牌>', 'API 令牌')； - 选项冲突/默认值：第三个参数即默认值，环境变量回退在 action 里处理。
彩色输出与交互增强
Commander 管解析，体验增强靠搭档：
npm install chalk @inquirer/prompts
const chalk = require('chalk');
const { confirm, input } = require('@inquirer/prompts');
console.log(chalk.green('✓ 部署成功'));
console.log(chalk.red('✗ 部署失败'));
// 缺参数时交互式补齐而非直接报错
if (!options.env) {
options.env = await input({ message: '目标环境？', default: 'staging' });
}
const yes = await confirm({ message: '确认部署到生产环境？' });
专业 CLI 的体验公式：关键操作要确认、结果用颜色区分、缺参数给提示而非报错。
组织大型 CLI
子命令一多，拆成独立文件：每个命令 new Command() 导出，主程序 program.addCommand() 组装。可执行文件记得加 shebang（#!/usr/bin/env node）并在 package.json 配 bin 字段，npm link 后即可全局调用。
常见问题（FAQ）
Q：Commander 和 yargs、cac、clipanion 怎么选？
Commander API 最直白、生态最大；yargs 功能类似风格略异；cac 更轻；clipanion 类型安全最好（TS 项目）。无特殊需求 Commander 是稳妥默认项。
Q：怎么处理异步 action 的错误？
action 里用 async/await，外层 program.parseAsync() 替代 parse()，异常用 try/catch 包裹后 console.error + process.exit(1)——CLI 的约定：失败必须非零退出码，脚本才能感知。
Q：选项值能来自环境变量吗？
Commander 原生支持有限，惯用做法是 action 里 options.token || process.env.API_TOKEN，或配合 dotenv 加载 .env。优先级惯例：命令行参数 > 环境变量 > 配置文件 > 默认值。
参考文档
本文依据公开文档整理，示例需按项目依赖版本验证；不将文档中的性能描述视为本项目实测结果。
