Husky项目pre-commit钩子执行失败的解决方案

在Node.js项目中使用Husky进行Git钩子管理时，开发者可能会遇到pre-commit脚本执行失败的问题。本文将深入分析这一常见问题的原因，并提供多种解决方案。

问题现象

当开发者按照标准流程安装Husky并配置pre-commit钩子后，在提交代码时可能会遇到以下错误信息：

.husky/pre-commit: .husky/pre-commit: cannot execute binary file
husky - pre-commit script failed (code 126)

根本原因分析

这个问题的产生通常与文件创建方式和执行权限有关：

1. 文件创建方式不当：在Windows系统的Visual Studio Code终端中使用echo命令创建钩子文件时，可能会产生格式问题
2. 执行权限缺失：创建的脚本文件可能缺少可执行权限
3. 脚本内容格式错误：脚本文件可能包含不正确的格式或字符

解决方案

方案一：手动创建钩子文件

1. 在项目根目录的.husky文件夹中手动创建pre-commit文件
2. 直接编辑文件内容，写入需要执行的命令，例如：

#!/bin/sh
npm run lint

方案二：使用命令行正确创建

在Windows系统的cmd终端中（而非VSCode终端）执行以下命令：

echo npm run lint-staged > .husky/pre-commit

注意不要使用引号包裹命令内容。

方案三：简化脚本内容

如果问题与lint-staged相关，可以尝试简化pre-commit脚本，直接运行其他命令如代码格式化：

#!/bin/sh
npm run format

最佳实践建议

1. 跨平台兼容性：在Windows系统开发时，建议使用Git Bash或WSL终端来创建和管理Husky钩子
2. 文件权限检查：确保钩子脚本具有可执行权限
3. 脚本验证：创建后检查脚本文件内容是否符合预期，避免特殊字符或格式问题
4. 版本适配：确认使用的Husky版本与项目环境兼容

通过以上方法，开发者可以有效解决Husky pre-commit钩子执行失败的问题，确保Git钩子能够正常工作。