Skip to content

Husky 高效使用指南

在 ArenaPro 项目中,.husky文件夹是自动化工作流的核心。通过编辑此文件夹中的配置文件,你可以精确定制Git 操作前的钩子规则,构建自动化质量保障机制,确保只有符合团队标准的高质量代码才能提交到代码仓库。

初始化提示

首次克隆 AP 项目时,你可能会发现.husky文件夹下的_文件夹为空,这会导致 Git 钩子无法正常工作。若遇到此情况,请在项目根目录下执行npm run prepare命令来完成 Husky 的初始化设置。

与 Lint-Staged 的强力协作

在项目中,.lintstagedrc文件是配置 Lint-Staged 执行规则的关键。

当 Husky 与Lint-Staged协同工作时,它们能在 Git 提交前智能地识别并只对暂存区中的文件进行精准校验。通过精心配置,系统会自动调用ESlint + Prettier对代码进行全方位检查、智能修复问题并统一格式化,从而确保代码库始终保持高质量标准。

👇

当 TypeScript 代码通过所有质量检查时,Git 提交操作将顺利完成,代码安全地进入仓库。

相反,如果 TypeScript 代码中存在质量问题,Git 提交将被智能拦截,防止有问题的代码进入代码库。

更多高级应用

值得一提的是,Husky 支持丰富多样的 Git 钩子类型,包括但不限于Git 提交Git 推送Git 拉取Git 重置Git 检出Git 合并以及Git 标签等核心操作。你可以根据项目的具体需求,在这些钩子中设置自定义的自动化脚本,实现高度灵活和定制化的代码管理流程与质量控制体系。

通过充分发挥 Husky 的强大功能,你将能够显著提升团队的协作效率,确保代码库的长期稳定性和一致性,为项目的可持续发展奠定坚实基础。