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

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

1. 直接使用 Node.js 内置的命令行 API（process.argv）
   Node.js 自带process.argv属性，它是一个数组，包含命令行参数：

   • 第 0 项：Node.js 可执行文件路径
   • 第 1 项：脚本文件路径
   • 从第 2 项开始：用户传入的参数

   示例（cli.js）：

   console.log(process.argv.slice(2));// 输出用户参数constargs=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。）

2. 使用轻量级参数解析库
   最流行的是：

   • Commander.js：最常用（每周下载量超 2 亿），API 简单，支持子命令、选项、自动帮助生成、版本等。
   • Yargs：功能丰富，支持声明式语法、中间件、自动帮助、验证、彩色输出等。
   • Meow或Minimist：更轻量，适合小型工具。

   示例（使用 Commander.js）：

   #!/usr/bin/env nodeconst{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();

   这些库适合大多数场景，开发快速、社区活跃。

3. 使用完整 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 示例（生成项目后）：

   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 会更友好。