部署Codepen项目到GitHub Pages时，yarn start遇if-env、eslint未找到错误

错误核心原因 #

报错指向两个关键问题：

• if-env命令未找到：该工具是项目脚本依赖的npm包，未安装或安装不完整
• eslint命令未找到：项目开发依赖中缺少代码检查工具eslint

修复步骤 #

1. 清理缓存并重新安装依赖 #

先移除旧依赖文件，避免缓存干扰：

# 删除node_modules文件夹
rm -rf node_modules
# 删除yarn.lock锁文件
rm yarn.lock
# 重新安装所有依赖
yarn install

2. 手动安装缺失的依赖包 #

如果重新安装后问题仍存在，直接安装缺失的工具：

# 安装if-env（用于环境变量判断）
yarn add if-env --dev
# 安装eslint及React相关检查插件
yarn add eslint eslint-plugin-react eslint-plugin-react-hooks --dev

3. 优化package.json脚本配置 #

检查package.json的scripts字段，把start命令改成更兼容的写法（避免依赖全局工具）：

"scripts": {
  "start": "NODE_ENV=production && npm run react-project:start:prod || npm run react-project:start:dev",
  "react-project:start:dev": "eslint modules && react-project start"
}

4. 版本兼容性验证 #

你当前的Node v16.20.0、npm 8.19.4、yarn 1.22.19版本组合完全兼容，硬件过时不是问题根源。

5. 测试修复效果 #

重新执行启动命令：

yarn start

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