答案：Composer 不自动处理 Git submodule，需配置 source 安装并用 post-install-cmd 脚本执行 git submodule update --init --recursive 以正确拉取子模块。
在使用 Composer 管理 PHP 项目依赖时，如果遇到的某个包是通过 Git submodule 引入的，你可能会发现 Composer 并不会自动处理这些 submodule。这是因为 Composer 只负责下载代码包，并不执行 Git 操作。下面告诉你如何正确处理包含 Git submodule 的依赖。
理解 Composer 和 Git Submodule 的关系
Composer 安装依赖时，默认从 Packagist 下载压缩包或克隆 Git 仓库（取决于配置）。但即使克隆了仓库，Git submodule 不会自动初始化和更新。这意味着如果你依赖的库本身使用了 submodule 来引入其他组件，你需要手动干预或通过脚本自动化处理。
常见场景包括：
- 你引用了一个私有 Git 包，它内部依赖另一个私有库作为 submodule
- 某些框架或工具包使用 submodule 组织模块
启用 Git 克隆而非下载 ZIP
要让 submodule 生效，必须确保 Composer 使用 Git 克隆仓库，而不是下载 ZIP 包。ZIP 包通常不包含 .git 文件，也无法还原 submodule。
"config": { "preferred-install": { "your-vendor/your-package": "source" } }或者全局设置：
"config": { "preferred-install": "source" }这样 Composer 会用 git clone 而不是下载归档文件，保留 .git 信息，为后续 submodule 操作打基础。
自动初始化 submodule
你可以利用 Composer 的 scripts 功能，在安装或更新后自动执行 Git 命令来拉取 submodule。
示例配置：
"scripts": { "post-install-cmd": [ "for dir in vendor/*/*; do (cd \"$dir\" && git submodule update --init --recursive) || true; done" ], "post-update-cmd": [ "for dir in vendor/*/*; do (cd \"$dir\" && git submodule update --init --recursive) || true; done" ] }说明：
- post-install-cmd 和 post-update-cmd 是 Composer 提供的钩子
- 遍历 vendor 目录下所有已克隆的包，尝试执行 submodule 初始化
- 加 || true 防止非 submodule 项目报错中断流程
更精确的做法是只针对特定包执行：
"scripts": { "post-install-cmd": [ "cd vendor/your-vendor/your-package && git submodule update --init --recursive" ] }注意事项与最佳实践
使用 submodule + Composer 存在一些潜在问题，需要注意：
- 权限问题：submodule 往往指向私有仓库，确保 CI/部署环境有权限访问
- 性能影响：每次更新都要递归拉取 submodule，可能变慢
- 可维护性差：相比直接通过 Composer 声明依赖，submodule 更难追踪版本
- 推荐替代方案：尽可能将 submodule 改造成 Composer 包并发布到私有仓库（如 Satis 或 Packagist 私有版）
基本上就这些。虽然可以靠脚本让 Composer 支持 Git submodule，但这属于“补救措施”。理想情况是避免在 Composer 包中使用 submodule，改用标准依赖管理方式，更清晰也更容易协作。
