用JS打造命令行工具：Node.js实战教学

想用 JavaScript 和 Node.js 实现一个命令行工具？其实并不难。Node.js 提供了完整的系统能力，可以轻松读取命令行参数、执行操作并输出结果。下面一步步教你如何从零开始创建一个简单的 CLI 工具。

1. 初始化项目

打开终端，创建项目目录并初始化 npm：

• mkdir my-cli-tool
• cd my-cli-tool
• npm init -y

这会生成 package.json 文件，是 Node.js 项目的配置核心。

2. 创建主脚本文件

新建一个 index.js 作为入口文件：

#!/usr/bin/env node

console.log('Hello from your CLI tool!');

第一行 #!/usr/bin/env node 是“shebang”，告诉系统这个文件要用 Node.js 执行。这是制作可执行脚本的关键。

3. 配置 package.json 可执行命令

修改 package.json，添加 bin 字段：

{
  "name": "my-cli-tool",
  "version": "1.0.0",
  "bin": {
    "mytool": "./index.js"
  },
  "preferGlobal": true
}

这样安装后就能通过 mytool 命令调用你的脚本。

4. 解析命令行参数

Node.js 的 process.argv 可以获取输入的参数。例如：

const args = process.argv.slice(2);
if (args[0] === 'greet') {
  console.log('Hi there,', args[1] || 'Guest');
}

运行 node index.js greet Alice 会输出：Hi there, Alice。

更推荐使用第三方库如 yargs 或 commander 来处理复杂逻辑。

安装 yargs：

npm install yargs

更新 index.js：

#!/usr/bin/env node

const yargs = require('yargs');

yargs
  .command('greet <name>', 'Say hello', (yargs) => {
    yargs.positional('name', {
      describe: 'Who to greet',
      type: 'string'
    });
  }, (argv) => {
    console.log(`Hello, ${argv.name}!`);
  })
  .help()
  .argv;

现在运行 mytool greet John 就能看到问候信息。

5. 全局安装与使用

在项目目录下运行：

npm link

这条命令会把你的工具软链接到全局环境，之后就可以直接使用 mytool 命令了。

如果要发布到 npm，运行 npm publish（需要注册账号），别人就能通过 npm install -g my-cli-tool 安装使用。

6. 添加更多功能示例

比如添加一个生成文件的命令：

const fs = require('fs');

yargs
  .command('create <filename> [content]', 'Create a file', (yargs) => {
    yargs
      .positional('filename', { type: 'string' })
      .positional('content', { type: 'string', default: 'Hello!' });
  }, (argv) => {
    fs.writeFileSync(argv.filename, argv.content);
    console.log(`${argv.filename} created.`);
  })

运行 mytool create note.txt "This is cool" 就会生成文件。

基本上就这些。你可以继续扩展命令、加颜色输出（用 chalk 库）、支持配置文件等。Node.js 让 JS 不只跑在浏览器里，也能成为强大的脚本语言。