详解用Node.js写一个简单的命令行工具

那么我们来详细讲解一下如何用Node.js写一个简单的命令行工具。可以按照以下步骤进行操作：

第一步：创建一个新的Node.js项目

首先，需要创建一个新的Node.js项目。在命令行中，可以使用以下命令来创建一个新的项目：

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

这将会让你进入一个交互式命令行，你需要回答一些问题来初始化你的新项目。

第二步：安装commander包

接下来，需要安装commander包，commander是一个常用的用于构建命令行工具的包，可以大大简化工具的开发。

npm install commander

第三步：开始编写代码

现在，可以开始编写代码了。这里给出一个示例代码：

#!/usr/bin/env node

const program = require('commander');

// 定义命令行参数
program
  .version('0.1.0')
  .option('-n, --name <name>', 'your name')
  .option('-a, --age <age>', 'your age')
  .parse(process.argv);

// 输出结果
console.log(`Hello, my name is ${program.name} and I am ${program.age} years old.`);

第四步：将代码保存为可执行文件

完成代码编写之后，需要将其保存为可执行文件。可以使用以下命令将文件保存为可执行文件：

chmod +x index.js

第五步：测试工具

现在，可以尝试使用工具测试一下了。在命令行中输入以下命令：

./index.js -n John -a 30

这将会输出以下结果：

Hello, my name is John and I am 30 years old.

这个示例工具简单地解析了命令行参数，并输出了一句话。

再举一个更为复杂的示例：假设现在需要开发一个工具，可以将指定路径下的所有Markdown文件转换成HTML文件，并将结果输出到指定的文件夹中。可以参考以下代码：

#!/usr/bin/env node

const fs = require('fs');
const path = require('path');
const marked = require('marked');
const program = require('commander');

// 定义命令行参数
program
  .version('0.1.0')
  .option('-i, --input <path>', 'input directory')
  .option('-o, --output <path>', 'output directory')
  .parse(process.argv);

// 定义Markdown转换函数
function convertMarkdown(pathname, outfile) {
  fs.readFile(pathname, 'utf8', function(err, data) {
    if (err) throw err;
    const html = marked(data);
    fs.writeFile(outfile, html, function(err) {
      if (err) throw err;
      console.log(`Converted ${pathname} to ${outfile}`);
    });
  });
}

// 读取输入文件夹中所有的Markdown文件，并转换
fs.readdir(program.input, function(err, files) {
  if (err) throw err;
  files.forEach(function(file) {
    const extname = path.extname(file);
    if (extname === '.md' || extname === '.markdown') {
      const pathname = path.join(program.input, file);
      const outfile = path.join(program.output, `${path.basename(file, extname)}.html`);
      convertMarkdown(pathname, outfile);
    }
  });
});

值得注意的是，这个示例中，我们使用了fs、path和marked这三个Node.js的核心模块来处理文件及Markdown转换。

完成以上步骤之后，就可以使用这个工具来将Markdown文件转换成HTML文件了。执行以下命令：

./md2html.js -i input_dir/ -o output_dir/

其中，input_dir/是存放Markdown文件的目录，output_dir/是存放输出HTML文件的目录。

希望这些示例可以帮助你更好地理解如何用Node.js构建一个简单的命令行工具。