Node.js CLI工具异常：替换.gitignore文件失败及优化咨询

首先，咱们来定位你遇到的核心问题：exec的close事件不管命令执行成功与否都会触发，所以哪怕wget命令实际失败了，你还是会看到“New test/.gitignore created...”的提示，但文件并没有生成。另外，wget不是所有系统（比如Windows默认环境）都预装的工具，这也可能是隐藏的坑。

一、快速修复：给exec添加完整的错误处理 #

修改你下载.gitignore的代码块，添加错误回调和输出检查，这样就能看到命令执行的真实情况：

exec(
  `wget -O ./${name}/.gitignore https://raw.githubusercontent.com/github/gitignore/master/Node.gitignore`,
  (error, stdout, stderr) => {
    spinner.stop();
    if (error) {
      console.error(chalk.red(`下载失败: ${error.message}`));
      return;
    }
    if (stderr) {
      console.error(chalk.red(`wget执行错误: ${stderr}`));
      return;
    }
    console.log(chalk.green(`\nNew ${name}/.gitignore created...`));
  }
)

运行后你就能看到具体的错误信息（比如wget未安装、路径权限问题等），针对性解决即可。

二、更可靠的方案：用Node内置模块替代wget #

依赖外部工具总会有兼容性问题，用Node自带的https模块下载文件，跨平台性更好，也不需要额外安装工具：

const https = require('https');
const path = require('path'); // 用来处理跨平台路径

// 替换原来的exec下载部分
console.log(`\nPlacing new gitignore file...`);
spinner.start();

const targetPath = path.join(__dirname, name, '.gitignore');
const fileStream = fs.createWriteStream(targetPath);

https.get('https://raw.githubusercontent.com/github/gitignore/master/Node.gitignore', (response) => {
  if (response.statusCode !== 200) {
    spinner.stop();
    console.error(chalk.red(`下载失败: 状态码 ${response.statusCode}`));
    return;
  }
  // 把下载的内容写入文件
  response.pipe(fileStream);
  fileStream.on('finish', () => {
    fileStream.close();
    spinner.stop();
    console.log(chalk.green(`\nNew ${name}/.gitignore created...`));
  });
}).on('error', (err) => {
  spinner.stop();
  console.error(chalk.red(`下载出错: ${err.message}`));
});

三、代码优化建议：避免回调地狱，提升健壮性 #

你的代码现在嵌套了多层回调，可读性和可维护性都不太好，推荐用Promise+async/await重构，同时完善错误处理和输入验证：

const chalk = require("chalk");
const figlet = require("figlet");
const { promisify } = require('util');
const exec = promisify(require("child_process").exec);
const ora = require("ora");
const fs = require("fs").promises; // 用promise版本的fs
const path = require('path');
const https = require('https');
const readline = require("readline").createInterface({
  input: process.stdin,
  output: process.stdout
});

const spinner = ora();

// 封装下载函数为Promise
const downloadGitignore = (projectName) => {
  return new Promise((resolve, reject) => {
    const targetPath = path.join(__dirname, projectName, '.gitignore');
    const fileStream = fs.createWriteStream(targetPath);
    
    https.get('https://raw.githubusercontent.com/github/gitignore/master/Node.gitignore', (res) => {
      if (res.statusCode !== 200) {
        reject(new Error(`下载失败，状态码：${res.statusCode}`));
        return;
      }
      res.pipe(fileStream);
      fileStream.on('finish', resolve);
    }).on('error', reject);
  });
};

// 主逻辑用async/await
readline.question(`What is your project name? `, async (name) => {
  process.stdout.write("\x1Bc");
  console.log(chalk.green(figlet.textSync("My CLI Tool", { horizontalLayout: "full" })));

  try {
    // 1. 创建React项目
    console.log(`\nCreating a React project named: ${name} ...`);
    spinner.start();
    await exec(`npx create-react-app ${name}`);
    spinner.stop();
    console.log(chalk.green(`\nProject ${name} created...`));

    // 2. 删除旧.gitignore
    console.log(`\nRemoving old ${name}/.gitignore file...`);
    spinner.start();
    const gitignorePath = path.join(__dirname, name, '.gitignore');
    await fs.unlink(gitignorePath);
    spinner.stop();

    // 3. 下载新.gitignore
    console.log(`\nPlacing new gitignore file...`);
    spinner.start();
    await downloadGitignore(name);
    spinner.stop();
    console.log(chalk.green(`\n✅ All operations completed successfully!`));
  } catch (err) {
    spinner.stop();
    console.error(chalk.red(`❌ Error: ${err.message}`));
  } finally {
    readline.close();
  }
});

额外优化点：

• 用path.join处理路径，避免Windows/Linux路径分隔符不一致的问题
• 统一用async/await处理异步操作，代码结构更清晰
• 给用户添加成功/失败的视觉反馈（用chalk的颜色和emoji）
• 可以加入项目名称合法性检查（比如是否为空、是否已存在该文件夹）

内容的提问来源于stack exchange，提问作者nopassport1