如何利用JavaScript实现命令行界面(CLI)工具？-js教程-PHP中文网

如何利用JavaScript实现命令行界面(CLI)工具？

betcha

发布： 2025-10-11 20:15:01

原创

358人浏览过

使用Node.js结合yargs、commander和inquirer库可高效构建CLI工具，通过process.argv获取参数，借助yargs或commander解析命令，用inquirer实现交互输入，并通过package.json的bin字段和npm link发布为全局命令。

如何利用javascript实现命令行界面(cli)工具？

用 JavaScript 实现命令行界面（CLI）工具，主要依赖 Node.js 环境和一些辅助库。Node.js 提供了与系统交互的能力，而第三方库让参数解析、用户输入、颜色输出等变得更简单。下面介绍实现 CLI 工具的关键步骤和常用方法。

使用 Node.js 的内置模块读取命令行参数

Node.js 提供 process.argv 来获取命令行传入的参数。这个数组包含执行命令的所有部分，前两个是 node 路径和脚本路径，之后是用户输入的参数。

例如：

假设你有一个文件 cli.js：

const args = process.argv.slice(2);
console.log('参数:', args);

登录后复制

运行命令：

node cli.js --name Alice --age 25

登录后复制

输出为：

立即学习“Java免费学习笔记（深入）”；

参数: ['--name', 'Alice', '--age', '25']

登录后复制

你可以手动解析这些参数，但更推荐使用专门的库来处理。

使用 yargs 或 commander 解析命令和选项

手动解析参数容易出错且难以维护。推荐使用成熟库如 yargs 或 commander。

yargs 示例：

#!/usr/bin/env node

const yargs = require('yargs');

yargs
  .command('hello [name]', '打招呼', (yargs) => {
    yargs.positional('name', {
      describe: '你的名字',
      type: 'string'
    });
  }, (argv) => {
    console.log(`Hello, ${argv.name}!`);
  })
  .help()
  .argv;

登录后复制

保存为可执行文件并添加权限后，运行：

./cli.js hello Alice

登录后复制

输出：Hello, Alice!

commander 示例：

LuckyCola工具库

LuckyCola工具库是您工作学习的智能助手，提供一系列AI驱动的工具，旨在为您的生活带来便利与高效。

查看详情

const { program } = require('commander');

program
  .version('1.0.0')
  .command('greet <name>')
  .description('打招呼')
  .action((name) => {
    console.log(`Hi, ${name}!`);
  });

program.parse();

登录后复制

效果类似，语法更链式化，适合复杂命令结构。

支持交互式输入（inquirer）

如果需要用户逐项输入，可以用 inquirer.js 实现交互式问答。

const inquirer = require('inquirer');

inquirer
  .prompt([
    { type: 'input', name: 'name', message: '你的名字？' },
    { type: 'list', name: 'color', message: '喜欢的颜色？', choices: ['红', '绿', '蓝'] }
  ])
  .then((answers) => {
    console.log(`你好 ${answers.name}，你喜欢 ${answers.color}`);
  });

登录后复制

这种模式适合配置向导或初始化工具。