如何用Node.js按名称查找本地文件？Oclif CLI开发场景

1. 自动向上递归搜索（跨平台） #

通过循环遍历当前目录的所有上级目录，逐个执行glob搜索，直到到达文件系统根目录。这种方式无需用户额外输入，自动覆盖所有可能的上级路径，且跨平台兼容。

const path = require('path');
const glob = require('glob');

function findUpwardConfigFiles(pattern = '*.appName.json') {
  let currentDir = process.cwd();
  const matchedFiles = [];

  while (true) {
    // 在当前目录搜索匹配文件
    const files = glob.sync(path.join(currentDir, pattern), { absolute: true });
    matchedFiles.push(...files);

    // 获取上级目录
    const parentDir = path.dirname(currentDir);
    // 判断是否到达根目录（兼容Windows/Unix）
    if (parentDir === currentDir) break;

    currentDir = parentDir;
  }

  return matchedFiles;
}

// 使用示例
const configFiles = findUpwardConfigFiles();
console.log('找到的配置文件:', configFiles);

可选优化：限制搜索深度 #

如果担心搜索范围过大，可以添加最大层级限制，避免无意义地遍历到根目录：

function findUpwardConfigFiles(pattern = '*.appName.json', maxDepth = 3) {
  let currentDir = process.cwd();
  const matchedFiles = [];
  let currentDepth = 0;

  while (currentDepth < maxDepth) {
    const files = glob.sync(path.join(currentDir, pattern), { absolute: true });
    matchedFiles.push(...files);

    const parentDir = path.dirname(currentDir);
    if (parentDir === currentDir) break;

    currentDir = parentDir;
    currentDepth++;
  }

  return matchedFiles;
}

2. 允许用户指定搜索路径（更灵活安全） #

在Oclif命令中添加自定义参数，让用户手动指定搜索的起始目录（可以是上级目录），既满足需求又避免过度遍历：

const { Command } = require('@oclif/core');
const path = require('path');
const glob = require('glob');

class SearchConfigCommand extends Command {
  static description = '搜索并读取*.appName.json配置文件';

  static args = [
    {
      name: 'searchPath',
      default: process.cwd(),
      description: '搜索起始目录（支持上级目录，如../或../../）',
      required: false,
    },
  ];

  async run() {
    const { args } = await this.parse(SearchConfigCommand);
    const searchPattern = path.join(args.searchPath, '**/*.appName.json');
    const configFiles = glob.sync(searchPattern, { absolute: true });

    if (configFiles.length === 0) {
      this.log('未找到匹配的配置文件');
      return;
    }

    this.log(`找到${configFiles.length}个配置文件:`);
    configFiles.forEach(file => this.log(`- ${file}`));

    // 后续读取文件逻辑...
  }
}

module.exports = SearchConfigCommand;

用户使用时可以直接指定上级目录：

my-cli search-config ../

3. 直接指定上级目录的glob模式（简单场景） #

如果只需要搜索当前目录的父目录及子目录，可直接使用包含上级路径的glob模式：

const files = glob.sync('../**/*.appName.json', { absolute: true });

这种方式适合明确知道需要搜索的层级，但灵活性不如前两种方案。

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