React项目Lint Staged提示无匹配暂存文件的原因及解决方法

错误原因 #

1. 文件匹配模式存在无效空格：你配置里的{js, ts, tsx}中，逗号后面的空格会导致glob匹配规则失效，lint-staged无法识别带空格的扩展名列表。
2. 没有暂存符合规则的文件：lint-staged只处理Git暂存区里的文件，如果执行命令前没有用git add把相关文件加入暂存区，自然找不到要处理的目标。
3. 少数情况下可能是项目目录结构或.gitignore规则导致匹配不到文件，但前两种是最常见的诱因。

解决步骤 #

1. 修正lint-staged的匹配规则 #

把package.json里的lint-staged配置中的扩展名列表空格去掉：

"lint-staged": {
  "**/*.{js,ts,tsx}": [
    "yarn format"
  ]
}

保存后重新尝试运行命令。

2. 确保有暂存的目标文件 #

执行以下命令将需要检查的文件加入Git暂存区：

git add .

或者指定具体文件：

git add src/components/YourComponent.tsx

之后再运行yarn lint-staged即可正常触发格式化任务。

3. 调试匹配过程（可选） #

如果问题仍存在，可以用debug模式查看lint-staged的匹配细节：

npx lint-staged --debug

通过输出日志确认是否有文件被正确匹配到，排查是否存在其他路径或忽略规则的问题。

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