Husky项目中CRLF与LF换行符问题解析

问题背景

在使用Husky这个Git钩子管理工具时，开发者可能会遇到一个看似简单却令人困惑的问题：当.husky/pre-commit钩子脚本包含CRLF换行符时，执行git commit命令会失败并返回错误代码129。而同样的脚本内容，如果使用LF换行符，则能正常工作。

问题现象

具体表现为：

1. 在Windows环境下使用某些IDE（如PHPStorm）创建.husky/pre-commit文件时，默认可能使用CRLF换行符
2. 当执行git commit命令时，Husky会报错"unknown option: -v"
3. 错误代码129表明这是一个shell执行错误

技术原理

这个问题本质上与Unix/Linux系统处理换行符的方式有关：

1. CRLF与LF的区别：

   • CRLF是Windows系统的标准换行符（回车+换行，即\r\n）
   • LF是Unix/Linux系统的标准换行符（仅换行，即\n）

2. Shell解释器行为：

   • 在Unix/Linux环境下，shell解释器会将CR字符视为命令的一部分
   • 当执行git -v时，实际执行的是git -v\r，导致Git无法识别这个参数

3. Husky的执行机制：

   • Husky在调用Git钩子时，会直接执行脚本内容
   • 如果脚本包含不正确的换行符，会导致命令解析失败

解决方案

1. 手动修改换行符：

   • 使用echo命令创建文件，确保使用LF换行符
   • 示例：echo 'git -v' > .husky/pre-commit

2. IDE配置调整：

   • 在PHPStorm等IDE中，可以设置默认使用Unix风格换行符
   • 路径：File → Settings → Editor → Code Style → Line separator → 选择"Unix and macOS (\n)"

3. Git全局配置：

   • 设置Git自动转换换行符：git config --global core.autocrlf input
   • 这样在提交时会自动将CRLF转换为LF

最佳实践建议

1. 对于跨平台开发项目，建议统一使用LF换行符
2. 在团队协作时，可以在项目根目录添加.gitattributes文件，明确指定换行符处理规则
3. 使用编辑器插件或工具检查文件换行符格式
4. 对于Husky钩子脚本，建议使用简单的shell命令，避免复杂逻辑

总结

Husky作为Git钩子管理工具，其脚本执行依赖于底层shell环境。在Unix/Linux环境下，CRLF换行符会导致命令解析异常。开发者应当注意跨平台开发时的换行符一致性，特别是在处理脚本文件时。通过正确配置开发环境和工具，可以有效避免这类问题的发生。