在lint-staged中实现不同Git钩子的差异化配置

在实际开发中，我们经常需要在不同的Git钩子阶段执行不同的代码检查和测试任务。以lint-staged为例，开发者可能希望在提交前(pre-commit)只运行轻量级的代码格式化检查，而在推送前(pre-push)执行更全面的测试验证。

需求背景分析

现代前端开发流程中，Git钩子工具如Husky配合lint-staged已成为标配。但默认情况下，所有钩子阶段都使用相同的配置，这可能导致：

1. 提交操作变慢：如果每次提交都运行所有测试，会影响开发效率
2. 测试覆盖不足：如果只在提交时运行基本检查，可能导致CI环境失败

解决方案

lint-staged支持通过命令行参数指定不同的配置文件，这为实现差异化配置提供了可能：

1. 创建两个配置文件：

   • .lintstagedrc.precommit.json - 用于pre-commit钩子
   • .lintstagedrc.prepush.json - 用于pre-push钩子

2. 在Husky配置中分别指定不同的配置文件：

// .husky/pre-commit
npx lint-staged --config .lintstagedrc.precommit.json

// .husky/pre-push  
npx lint-staged --config .lintstagedrc.prepush.json

配置示例

pre-commit配置（轻量级检查）:

{
  "*.{js,jsx,ts,tsx}": [
    "prettier --write",
    "eslint --fix"
  ]
}

pre-push配置（全面测试）:

{
  "*.{js,jsx,ts,tsx}": [
    "prettier --write",
    "eslint --fix",
    "jest --findRelatedTests"
  ]
}

技术要点

1. jest --findRelatedTests 参数会智能地只运行与修改文件相关的测试用例
2. 差异化配置可以显著提升开发体验，同时保证代码质量
3. 配置文件支持多种格式（JSON/YAML/JS等），可根据团队偏好选择

最佳实践建议

1. 将pre-commit阶段的检查限制在格式化和小范围语法检查
2. 在pre-push阶段加入单元测试、类型检查等耗时操作
3. 考虑团队开发习惯，平衡检查严格度和开发流畅度
4. 保持CI环境运行完整的测试套件，作为最后的质量关卡

通过这种分层检查策略，开发者可以在不牺牲代码质量的前提下，获得更流畅的本地开发体验。