Node.js项目如何从根目录正确运行ESLint避免误扫node_modules

触发node_modules目录报错的行为是否符合ESLint预期设计 #

• 这完全是ESLint使用链路里的正常表现，问题根源不是ESLint的默认忽略逻辑失效，而是命令行执行时的通配符展开机制和多数人的认知存在偏差。
• 大部分shell环境的默认配置下，你写的eslint ./**/*.js命令里的**，语义和单层通配符*完全一致，shell会在把命令传给ESLint之前，先把通配符展开成具体的文件路径列表——这个列表里就包含了node_modules目录下的所有.js文件。
• ESLint默认自带的node_modules忽略规则，只在ESLint自行遍历目录、扫描匹配文件时生效；一旦传入的参数里已经包含了本该被忽略的文件路径，这些内置忽略规则会被手动传入的路径覆盖，自然就会出现node_modules代码被校验、模块内部配置引用报错的问题。

是否必须把所有业务代码统一放入src目录 #

• 完全没有这类强制要求。
• “所有业务代码放src目录”只是前端社区沉淀下来的常见项目结构惯例，既不是ESLint的配置要求，也不是Node.js生态的硬性规范。
• 你当前的项目结构——根目录直接放置app.js、server.js这类入口文件，业务模块以controllers、database这类文件夹平级放在根目录——是完全可以正常适配ESLint校验的，不需要为了工具适配刻意重构目录结构。

不需要逐个子目录罗列路径的简洁实现方式 #

• 你目前采用的单独罗列所有业务路径的方式，本质是绕开了shell通配符展开的问题，直接把目标业务路径传给ESLint，所以能正常执行，但写法冗余、新增目录时还要同步修改校验命令，维护成本高。
• 最省心的方案是直接把校验命令改成eslint .：把目录路径直接作为参数传给ESLint后，它会自动递归遍历目录下的.js文件，同时严格执行默认的node_modules忽略规则，不需要自己写复杂的通配符匹配。
• 如果需要自定义跳过的目录/文件，可以在根目录新建.eslintignore文件，把需要排除的路径写进去，比手动罗列所有要校验的路径灵活很多。
• 如果确实需要使用通配符做匹配，在bash环境下可以先执行shopt -s globstar开启递归通配符支持，此时**才会具备真正的多层级递归匹配能力，搭配ESLint的忽略规则就能正常完成全量校验。

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