在Monorepo中为lint-staged配置多环境差异化规则

在大型前端项目中，Monorepo架构越来越流行，它允许我们在一个代码仓库中管理多个项目。这种架构下，每个子项目通常需要独立的代码质量检查配置。本文将以lint-staged工具为例，探讨如何在Monorepo中实现不同Git钩子下的差异化配置。

Monorepo中的lint-staged配置挑战

在Monorepo环境下，常见的做法是在每个子项目中放置独立的.lintstagedrc.json配置文件。当使用pre-commit钩子时，这种配置方式工作良好，因为lint-staged会自动发现并应用各个子项目中的配置文件。

然而，当我们需要为pre-push钩子创建不同的检查规则时，问题就出现了。例如，开发者可能希望在提交时运行快速检查，而在推送时执行更全面的检查。默认情况下，lint-staged会使用相同的配置文件，无法区分不同Git钩子的场景。

解决方案：动态JS配置

lint-staged不仅支持JSON格式的静态配置，还支持JavaScript格式的动态配置。这为我们提供了实现差异化配置的可能性。我们可以：

1. 将.lintstagedrc.json转换为.lintstagedrc.js文件
2. 在JS配置中根据环境变量或其他条件返回不同的配置对象

// .lintstagedrc.js
module.exports = process.env.LINT_MODE === 'push' 
  ? {
      // pre-push钩子的配置
      '*.js': ['eslint --fix', 'prettier --write']
    }
  : {
      // pre-commit钩子的默认配置
      '*.js': ['eslint --fix']
    }

实际应用示例

在项目实践中，我们可以这样设置Git钩子：

1. 在.husky/pre-commit中保持原有配置：

npm exec -- lint-staged

2. 在.husky/pre-push中设置环境变量后运行：

LINT_MODE=push npm exec -- lint-staged --diff="origin/develop...$(git rev-parse --abbrev-ref HEAD)"

这种方案既保持了Monorepo中各个子项目的配置独立性，又实现了不同Git钩子下的差异化检查策略。

进阶建议

对于更复杂的场景，还可以考虑以下优化：

1. 将公共配置提取到单独模块，避免重复
2. 根据修改文件的范围自动调整检查严格程度
3. 结合CI环境变量，实现本地与CI环境的差异化配置

通过灵活的JS配置，我们可以为Monorepo中的每个子项目创建精细化的代码质量检查策略，满足不同开发阶段的需求。