【node.js】如何使用 node.js 来制作命令行应用？

使用 Node.js 创建命令行应用（CLI）主要有以下几种方式，从简单到复杂逐步介绍：

直接使用 Node.js 内置的命令行 API（process.argv）

Node.js 自带 process.argv 属性，它是一个数组，包含命令行参数：
- 第 0 项：Node.js 可执行文件路径
- 第 1 项：脚本文件路径
- 从第 2 项开始：用户传入的参数
示例（cli.js）：
javascript 复制代码
```
console.log(process.argv.slice(2));  // 输出用户参数
const args = process.argv.slice(2);
if (args.length === 0) {
  console.log('请提供参数');
} else {
  console.log('你输入的参数：', args.join(' '));
}
```
运行：node cli.js hello world

优点：无依赖、最轻量，适合极简单的脚本或原型。

缺点：需要手动解析选项（如 --flag、-v）、子命令、帮助信息等，复杂时代码容易混乱。

（Node.js 18+ 有内置实验性解析器，但仍不推荐用于生产级 CLI。）
使用轻量级参数解析库

最流行的是：
- Commander.js：最常用（每周下载量超 2 亿），API 简单，支持子命令、选项、自动帮助生成、版本等。
- Yargs：功能丰富，支持声明式语法、中间件、自动帮助、验证、彩色输出等。
- Meow 或 Minimist：更轻量，适合小型工具。
示例（使用 Commander.js）：
javascript 复制代码
```
#!/usr/bin/env node
const { program } = require('commander');

program
  .version('1.0.0')
  .command('greet <name>')
  .description('问候某人')
  .option('-e, --excited', '兴奋模式')
  .action((name, options) => {
    console.log(`Hello, ${name}${options.excited ? '!!!' : ''}`);
  });

program.parse();
```
这些库适合大多数场景，开发快速、社区活跃。
使用完整 CLI 框架
- oclif （Open CLI Framework）：由 Salesforce 开源（原 Heroku CLI 基础），支持 TypeScript、插件系统、自动文档生成、测试工具、钩子（hooks）、多命令结构等。适合大型、可扩展、可插件化的企业级 CLI（如 Heroku、Salesforce CLI）。
  截至 2025 年，oclif 仍在活跃维护（GitHub 最近更新在 2025 年底），npm 下载量稳定，是复杂项目的首选。
- 其他：Gluegun（TypeScript 友好）、Clerc、Ink（用于交互式 UI，如 React 风格的终端界面）。
oclif 示例（生成项目后）：
bash 复制代码
```
npx oclif generate mycli
```
它会自动脚手架一个完整项目，支持插件扩展。

哪种方式最佳？

没有绝对的最佳，取决于项目规模和需求：

小型/简单 CLI （脚本、内部工具）：直接用 Commander.js 或 Yargs 最合适。轻量、灵活、学习成本低，几乎所有教程和示例都用它们。Commander.js 更流行，API 更直观。
中大型/可扩展 CLI （多子命令、插件、团队维护、TypeScript 支持）：oclif 是最佳选择。它提供结构化架构、插件系统、自动更新等高级功能，避免后期重构。许多大公司（如 Salesforce）用它构建生产级 CLI。
如果需要交互式提示（问用户输入），结合 Inquirer.js 或 Prompts 使用。
如果追求极致交互 UI（如进度条、表格），可加 Chalk （颜色）、Ora（加载动画）等辅助库。

总结推荐：

起步快 → Commander.js（90% 项目足够）
复杂企业级 → oclif

无论哪种，都建议在 package.json 的 "bin" 字段配置可执行命令，便于全局安装（npm link 或发布到 npm）。如果项目用 TypeScript，oclif 或 Gluegun 会更友好。