解决Lingui在Git预提交钩子中无法中断的问题

问题背景

在使用Lingui国际化工具时，开发者在Git预提交钩子(pre-commit hook)中遇到了一个棘手的问题：当钩子脚本执行lingui extract --clean或lingui compile --strict命令时，无法通过Ctrl+C正常中断脚本执行。这个问题影响了开发者的工作效率，特别是在需要快速终止长时间运行的提取或编译过程时。

问题现象分析

经过详细测试，发现以下现象：

1. 当Lingui命令正在执行时，Ctrl+C会被"劫持"，需要多次按下才能完全终止脚本
2. 在直接运行钩子脚本(./.git/hooks/pre-commit)时，需要按3次Ctrl+C才能完全终止
3. 通过Git运行(git hook run pre-commit)时，终端状态会出现异常，需要额外操作恢复
4. 只有Lingui相关命令(extract和compile)有此问题，其他npm命令表现正常

技术原理探究

这个问题实际上涉及Linux/Unix系统的信号处理机制和Node.js进程管理：

1. 信号处理机制：Ctrl+C会发送SIGINT信号给前台进程组
2. 进程组管理：npm启动的子进程可能创建了新的进程组
3. Node.js特性：Node.js进程默认会捕获SIGINT信号进行优雅关闭
4. Git钩子环境：Git运行钩子时可能设置了特殊的进程环境

Lingui作为Node.js程序，使用命令行参数处理包处理命令行参数，本身没有特殊处理中断信号。问题的根源在于npm和Node.js在Git钩子环境下的信号传播行为。

解决方案

经过实践验证，以下解决方案效果最佳：

1. 使用trap捕获信号

在Bash脚本开头添加信号捕获：

trap "exit 1" SIGINT

这会确保脚本在收到SIGINT信号时立即退出，而不是等待当前命令完成。

2. 完整解决方案示例

#!/usr/bin/env bash

# 颜色定义
RED='\033[0;31m'
GREEN='\033[0;32m'
NC='\033[0m'

# 工具函数
message() {
  echo -e "${2}${1}${NC}"
}
error() { message "$1" "$RED"; exit 1; }
success() { message "$1" "$GREEN"; }

# 确保在仓库根目录
cd "$(git rev-parse --show-toplevel)" || error "无法切换到Git仓库根目录!"

# 关键设置：捕获中断信号
trap "exit 1" SIGINT

# 执行国际化提取
npm --prefix assets run extract
./assets/js/locales/normalize.sh

# 执行编译检查
if npm --prefix assets run compile; then
  success "前端代码翻译完成。"
else
  error "提交失败：存在未翻译的前端代码!"
fi

# 其他检查...

3. 注意事项

1. 在Git钩子环境下，终端状态可能仍会有些异常，这是Git本身的行为
2. 对于长时间运行的Lingui操作，考虑添加超时机制
3. 在团队项目中，确保所有开发者都使用相同版本的Lingui和Node.js

深入理解

为什么Lingui命令会有这种特殊行为？这与以下因素有关：

1. 文件系统操作：Lingui在提取和编译时需要处理大量文件
2. Babel集成：Lingui与Babel深度集成，可能启动复杂转译过程
3. 多语言处理：处理多种语言时会创建多个并行任务

这些因素导致Lingui命令比普通Node.js命令更复杂，在信号处理上表现不同。

最佳实践建议

1. 对于大型项目，考虑将预提交钩子拆分为多个独立阶段
2. 可以添加进度指示，让开发者了解Lingui命令执行状态
3. 在CI环境中，使用专门的Lingui步骤而非Git钩子
4. 定期更新Lingui版本，关注相关改进

通过以上分析和解决方案，开发者可以更好地控制Git预提交钩子中的Lingui命令执行，提高开发效率和工作体验。