如何在Node.js中按文件名搜索文件及Google Cloud Storage特定存储桶中的文件？

针对你的两个需求，我来分别给出具体的实现思路和代码示例：

一、Node.js环境下按文件名搜索本地文件 #

在Node.js里搜索本地文件，有几种常用的方式：

1. 原生fs模块递归搜索 #

如果不想依赖第三方库，可以用fs.promises.readdir结合递归实现，遍历所有子目录并过滤文件名：

const fs = require('fs').promises;
const path = require('path');

async function searchLocalFiles(dir, targetFileName) {
  let results = [];
  const entries = await fs.readdir(dir, { withFileTypes: true });

  for (const entry of entries) {
    const fullPath = path.join(dir, entry.name);
    if (entry.isDirectory()) {
      results = [...results, await searchLocalFiles(fullPath, targetFileName)];
    } else {
      if (entry.name.includes(targetFileName)) { // 可替换为精确匹配：entry.name === targetFileName
        results.push(fullPath);
      }
    }
  }
  return results.flat();
}

// 调用示例
searchLocalFiles('./your-directory', 'name.json').then(files => console.log(files));

2. 使用glob库（更简便） #

glob库支持通配符搜索，非常适合按文件名/模式查找文件，安装后一行代码就能搞定递归搜索：

npm install glob

const glob = require('glob');

// 搜索所有子目录中包含name.json的文件
glob('**/*name.json', (err, files) => {
  if (err) throw err;
  console.log(files);
});

// 异步版本（Promise）
glob.promise('**/*name.json').then(files => console.log(files));

二、Google Cloud Storage（GCS）存储桶按文件名搜索 #

你提到用gsutil ls gs://bucket-name/**name.json能实现搜索，但@google-cloud/storage库的getFiles默认只支持前缀匹配。这里给你两种可行的方案：

1. 客户端遍历过滤（适合数千个文件的场景） #

GCS本身没有原生的全桶文件名搜索API（因为它是对象存储，按前缀/路径组织），但对于数千个文件来说，遍历整个桶的对象然后在客户端过滤是完全可行的，性能不会有太大问题：

const { Storage } = require('@google-cloud/storage');
const path = require('path');
const storage = new Storage();

async function searchGCSFilesByName(bucketName, targetFileName) {
  const bucket = storage.bucket(bucketName);
  // 自动分页获取桶内所有对象
  const [files] = await bucket.getFiles({ autoPaginate: true });
  
  // 过滤文件名：这里用includes实现包含匹配，可替换为endsWith或精确匹配
  const matchedFiles = files.filter(file => {
    // 若只想匹配文件名部分（忽略路径），用path.basename(file.name)
    return path.basename(file.name).includes(targetFileName);
  });

  // 返回匹配的文件信息，比如文件名、路径等
  return matchedFiles.map(file => ({
    name: file.name,
    publicUrl: file.publicUrl() // 如果需要公共访问URL的话
  }));
}

// 调用示例
searchGCSFilesByName('your-bucket-name', 'name.json').then(files => console.log(files));

2. 提前配置对象标签（适合长期高频搜索需求） #

如果需要更高效的搜索，可以给GCS对象添加自定义标签，然后通过标签过滤搜索。比如给每个文件添加fileName标签，值为文件名：

• 上传文件时添加标签：

await bucket.upload('local-file.json', {
  destination: 'subdir/name.json',
  metadata: {
    labels: {
      fileName: 'name.json'
    }
  }
});

• 搜索时通过标签过滤：

async function searchGCSFilesByLabel(bucketName, targetFileName) {
  const bucket = storage.bucket(bucketName);
  // 用标签过滤，只返回匹配的对象
  const [files] = await bucket.getFiles({
    filter: `labels.fileName:${targetFileName}`
  });
  return files.map(file => file.name);
}

这种方法不需要遍历全桶，但需要提前给所有目标文件添加标签，适合有长期搜索需求的场景。

补充说明 #

你用的gsutil ls gs://bucket-name/**name.json本质上是gsutil帮你做了全桶遍历+通配符过滤，和上面第一种客户端过滤的逻辑是一致的。对于数千个文件，第一种方案完全够用；如果文件数量增长到十万级以上，可以考虑结合BigQuery导出GCS元数据并建立索引，或者使用Cloud Search服务，但这两种方案复杂度更高。

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