npm脚本中ESLint无法读取参数文件名的问题排查

我来帮你捋一捋这个问题——直接执行ESLint命令正常，但通过自定义npm脚本调用就没输出，这种情况大多和子进程输出处理、glob模式解析或者脚本执行上下文有关，咱们一步步排查：

1. 检查脚本中子进程的输出捕获逻辑 #

如果你的脚本是用Node.js编写的（比如依赖child_process模块），默认情况下exec/spawn不会自动把ESLint的输出传递到终端。举个例子，如果你写了这样的代码：

const { exec } = require('child_process');
exec(`./node_modules/eslint/bin/eslint.js "${globPattern}"`, (err, stdout, stderr) => {
  // 这里如果没主动打印stdout/stderr，终端自然看不到输出
});

解决办法：要么在回调里显式打印输出，要么让子进程复用主进程的输入输出流：

// 方案1：用spawn并设置stdio: 'inherit'
const { spawn } = require('child_process');
spawn('./node_modules/eslint/bin/eslint.js', [globPattern], { 
  stdio: 'inherit', // 直接把ESLint的输出传到终端
  shell: true 
});

// 方案2：用exec时同样设置stdio
exec(`./node_modules/eslint/bin/eslint.js "${globPattern}"`, { stdio: 'inherit' });

2. 确认glob模式的引号处理是否正确 #

你直接在终端执行命令时，引号是给shell用的（防止glob被shell提前解析），但在Node.js脚本里，如果用exec（默认带shell），再给glob套引号会导致ESLint收到带引号的路径，它找不到匹配文件自然没输出。
排查步骤：在脚本里打印传给ESLint的参数，看看有没有多余引号：

console.log('当前要检查的路径:', globPattern);

解决办法：如果用spawn（不带shell），直接把glob作为数组元素传入即可，不需要加引号；如果用exec，可以去掉引号，让shell正常解析glob。

3. 检查files.txt的读取与内容处理 #

可能你的脚本读取files.txt时，没正确处理换行符、空格或空行，导致拿到的glob模式带多余字符（比如\n），ESLint找不到对应文件。
排查步骤：打印处理后的glob列表：

const fs = require('fs');
const globs = fs.readFileSync('./files.txt', 'utf8').split('\n').filter(Boolean);
console.log('待处理的glob规则:', globs);

解决办法：读取后清理每一行的多余字符，过滤空行：

const globs = fs.readFileSync('./files.txt', 'utf8')
  .split('\n')
  .map(line => line.trim()) // 去掉首尾空格、换行符
  .filter(line => line.length > 0); // 过滤空行

4. 确认npm脚本的工作目录 #

少数情况下，npm脚本的工作目录和你直接执行命令的目录不一致（比如在子目录运行npm），导致脚本找不到files.txt或ESLint的路径。
排查步骤：在脚本里打印当前工作目录：

console.log('当前工作目录:', process.cwd());

解决办法：用绝对路径定位文件，避免相对路径的问题：

const path = require('path');
const eslintPath = path.resolve(__dirname, './node_modules/eslint/bin/eslint.js');
const filesPath = path.resolve(__dirname, './files.txt');

5. 检查ESLint的错误信息 #

即使没有输出，也可以通过子进程的错误回调排查问题，比如：

exec(`./node_modules/eslint/bin/eslint.js ${globPattern}`, (err, stdout, stderr) => {
  if (err) {
    console.error('ESLint执行出错:', err);
    console.error('错误输出:', stderr);
  }
  console.log('正常输出:', stdout);
});

你可以先从第1点（子进程输出处理）开始排查，这是最常见的原因。如果还是解决不了，可以把你的脚本代码贴出来，能更精准地定位问题~

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