React项目文件夹命名引发ESLint报错问题求助

核心原因判断 #

代码修复后报错仍存在、仅特定目录可正常运行，说明问题不在代码本身，而是ESLint缓存、依赖解析或路径相关的工具链异常。

具体解决步骤 #

1. 清除ESLint缓存 #

ESLint默认会缓存检查结果，路径变更后缓存未更新会导致旧报错残留。执行命令清除缓存：

# yarn 方式
yarn eslint --clear-cache

# npm 方式
npx eslint --clear-cache

之后重新启动项目：

yarn start
# 或
npm start

2. 清除依赖缓存并重新安装 #

不同包管理器的缓存可能导致依赖加载异常，尤其是路径变更后模块解析路径出错：

# yarn 清除缓存并重装
yarn cache clean
rm -rf node_modules
rm yarn.lock
yarn install

# npm 清除缓存并重装
npm cache clean --force
rm -rf node_modules
rm package-lock.json
npm install

3. 检查ESLint配置文件 #

确认项目根目录的.eslintrc.js（或其他格式）和.eslintignore文件是否存在路径相关错误：

• 检查.eslintignore是否正确忽略/包含目标文件
• 确认eslint-plugin-react在plugins数组中，且react/destructuring-assignment、react/no-unknown-property规则配置正确

4. 重置编辑器ESLint服务 #

如果使用VS Code等IDE，可能是编辑器插件缓存了旧结果：

• 打开命令面板（Ctrl+Shift+P / Cmd+Shift+P），执行ESLint: Restart ESLint Server
• 关闭并重新打开项目窗口，让编辑器重新扫描当前路径文件

5. 验证路径兼容性 #

部分工具对路径中的特殊字符（括号、非ASCII字符等）解析存在bug，尝试将项目移动到无特殊字符的路径（如~/Desktop/NewUI/），重装依赖后启动测试。

6. 对齐ESLint插件版本 #

同事用npm能正常运行，可能是你的eslint-plugin-react版本与项目要求不一致：

# 查看已安装版本
yarn list eslint-plugin-react
# 或
npm list eslint-plugin-react

若版本不匹配，手动安装指定版本：

yarn add eslint-plugin-react@x.x.x --dev
# 或
npm install eslint-plugin-react@x.x.x --save-dev

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