git submodule update 反复失败因非幂等性导致状态异常时卡住；中文路径下 CaptainHook 钩子失效因 shell 脚本解析路径失败；K8s Init Container 中需显式指定工作目录并隔离环境；新成员需强制 --no-cache 触发钩子安装。
post-install-cmd 脚本里执行 git submodule update 为什么反复失败
因为 git submodule update --init --recursive 默认不幂等：若 submodule 已存在且状态正常，它不会报错；但一旦 submodule 目录被破坏（比如只写入一半、权限丢失、.git 目录损坏），再次执行就会卡在 clone 或 checkout 阶段，导致钩子退出码非零，进而中断 composer install 流程。
实操建议：
监控一个或多个 GitCode 仓库的 PR，通过 OpenClaw Gateway 自动执行 AI 审查，发布 PR 评论，并发送钉钉和企业微信通知。
- 改用带清理逻辑的封装脚本，例如先
rm -rf .git/modules/*和rm -rf vendor/*（谨慎！需判断是否在 CI 环境） - 或加前置校验：
git submodule status | grep -q '^+' && echo "dirty" || git submodule update --init --recursive - Windows 下避免直接用
rm，改用 PowerShell 脚本或 PHP 的exec('rd /s /q .git\modules')，并确保git命令在 PATH 中 - 必须在
composer.json的scripts中写成数组格式：["php scripts/submodule-check.php"]，而非字符串"php scripts/submodule-check.php"，否则 Windows 下可能解析失败
中文路径下 CaptainHook 的 pre-commit 钩子无法执行
根本原因是 Git 在 Windows 或某些 Linux shell 下对含中文字符的路径解析异常，而 captainhook install 生成的 .git/hooks/pre-commit 是 shell 脚本，其 shebang 行（如 #!/usr/bin/env bash）和后续命令若引用了含中文的项目路径（如 /home/张三/project），会导致 execve 失败，Git 直接跳过该钩子，不报错也不提示。
实操建议：
- 所有
captainhook.json中的command字段，路径一律用相对写法，且避开中文目录名："php ./scripts/check.php"，而不是"php scripts/检查.php" - 确保
captainhook.json中对应钩子的"enabled": true，这是最常被忽略的手动开关 - 验证钩子是否真正注册成功：运行
ls -l .git/hooks/pre-commit，输出中必须有-rwxr-xr-x权限；若为-rw-r--r--，需手动chmod +x .git/hooks/pre-commit - 开发机统一使用 WSL2 或 macOS，避免原生 Windows CMD/PowerShell 执行 shell 钩子——Git for Windows 自带的 bash 不保证 UTF-8 环境变量完整
Kubernetes Init Container 中 composer install 触发 submodule 更新的坑
Init Container 默认工作目录是 Pod 挂载点根路径，不是项目源码根目录；且 vendor/ 若挂载自 emptyDir，多次重启后残留状态会干扰 git submodule update，尤其当 submodule 使用 SSH 密钥认证时，.git/config 可能残留旧 URL 或凭据。
实操建议：
- 在 Init Container 的
command中显式cd /app（假设项目挂载到/app），再执行composer install - 把 submodule 初始化逻辑从 Composer 钩子移到 Init Container 的 shell 脚本中，便于控制执行顺序和错误处理
- 加环境变量隔离：
GIT_SSH_COMMAND="ssh -o StrictHostKeyChecking=no"，避免首次连接交互阻塞 - 不要依赖
post-install-cmd—— Init Container 中 Composer 运行时可能没加载用户 profile，PATH 缺失，导致git命令找不到
团队新成员 clone 后中文命名的 pre-commit 钩子完全没反应
因为 .git/hooks/ 不被 Git 跟踪，克隆后为空；而 captainhook install 又只在 post-install-cmd 触发，该阶段仅在 vendor/ 重建时运行。如果新成员直接 git clone && composer install --no-dev，且本地已有缓存的 vendor/，那钩子根本不会写入。
实操建议：
- 文档明确要求新成员执行
composer install --no-cache，强制重建vendor/，触发post-install-cmd - CI 流水线中加一步
ls -l .git/hooks/pre-commit || (echo "Hook missing!" && exit 1)，及早暴露问题 - 在项目根目录放一个
setup.sh，内容为composer install --no-cache && vendor/bin/captainhook install，并 chmod +x - 别指望“自动”——中文环境下的路径、编码、shell 兼容性叠加后，任何一步静默失败都极难排查，必须每步可验证
