You need to enable JavaScript to run this app. 执行Git提交时因Node依赖icu4c库缺失导致husky pre-commit钩子报错怎么解决
优惠活动
大模型
产品
解决方案
定价
更多

执行Git提交时因Node依赖icu4c库缺失导致husky pre-commit钩子报错怎么解决

Git提交时Node加载icu4c动态库报错解决

报错根因:Homebrew安装的Node在编译阶段绑定了指定版本(本例为67版本)的icu4c动态库,后续Homebrew升级icu4c后,旧版本动态库路径被替换,Node启动时找不到对应库文件直接触发崩溃,连带导致husky的pre-commit钩子执行中断,最终抛出134退出码。

可落地解决步骤

方案1:快速临时修复

适合当前需要紧急完成代码提交,不想重新安装整套Node环境的场景:

  • 首先确认本地当前安装的icu4c版本:执行 brew list icu4c --versions
  • 手动创建Node期望的旧版本动态库软链,把当前icu4c的库映射到Node找得到的路径:
    • 确保软链目标目录存在:mkdir -p /usr/local/opt/icu4c/lib
    • 依次创建三个核心icu4c库的软链:
      sudo ln -s /usr/local/Cellar/icu4c/$(brew list icu4c --versions | awk '{print $1}')/lib/libicui18n.*.dylib /usr/local/opt/icu4c/lib/libicui18n.67.dylib
      sudo ln -s /usr/local/Cellar/icu4c/$(brew list icu4c --versions | awk '{print $1}')/lib/libicuuc.*.dylib /usr/local/opt/icu4c/lib/libicuuc.67.dylib
      sudo ln -s /usr/local/Cellar/icu4c/$(brew list icu4c --versions | awk '{print $1}')/lib/libicudata.*.dylib /usr/local/opt/icu4c/lib/libicudata.67.dylib
      
  • 验证修复效果:执行 node -v,如果能正常输出版本号,重新执行Git提交命令即可。

方案2:长期彻底修复

避免后续Homebrew升级依赖时再次出现同类库找不到的问题:

  • 卸载当前和旧icu4c版本绑定的Node:brew uninstall --ignore-dependencies node
  • 重新安装适配当前系统icu4c版本的最新Node:brew install node
  • 安装完成后执行 node -v、yarn -v 确认工具链可正常调用,即可恢复Git提交流程。

特殊场景排查

  • 如果使用nvm/n等版本管理工具安装Node,无需调整Homebrew的软件版本,直接执行对应工具的重安装命令即可:比如nvm场景下执行 nvm reinstall <当前正在使用的Node版本号>,就会重新编译适配当前系统icu4c版本的Node二进制文件。
  • 修复后依然报错的话,执行 which node 确认当前调用的Node路径,排查是否存在多版本Node环境路径冲突,重启终端刷新环境变量后再测试。

内容的提问来源于stack exchange,提问作者Dorian

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.24 06:15:11