答案是用 find vendor -name '.git' -type d 定位残留 .git 目录，重点检查手动 clone 或 --prefer-source 安装后未清理的包；删掉孤立 .git 安全，但需确认是否真需 source 模式，ci 中推荐统一使用 --prefer-dist 规避问题。
composer install 报 fatal: not a git repository 怎么定位 .git 冲突
这不是网络或权限问题，是 Composer 在某个 vendor/xxx 子目录里误发现了残留的 .git 目录，试图执行 Git 操作却失败。它会卡在类似 fatal: not a git repository 或 Unable to locate a valid git directory 的报错上。
排查方法很简单：
- 用
find vendor -name '.git' -type d扫一遍，找出所有意外存在的.git目录 - 重点检查那些你手动
git clone过、或之前用composer install --prefer-source安装后又没清理的包 - 确认是否真需要 source 模式：如果只是想装包，
--prefer-dist更干净（zip 解压无.git）
为什么 composer status 看不到这些 .git 引发的问题
composer status 不处理这类孤立 .git。它只扫描「合法 source 包」——即由 Composer 自己以 --prefer-source 方式安装、且 .git 完整可操作的包。而手动残留的 .git 会导致 Git 命令失败，status 直接跳过该目录，既不报错也不提示。
换句话说：composer status 静音 ≠ 安全；空输出更不代表 vendor 干净。
- 它不检测
.git是否损坏或孤立 - 它不校验
.git与当前composer.lock中记录的 commit 是否匹配 - 它甚至不会告诉你“这个包有
.git但 Git 命令跑不通”
删掉 vendor 里的 .git 目录会不会影响依赖
只要不是你自己正在开发的那个包，删掉 vendor/xxx/.git 完全安全。Composer 后续安装时不会恢复它，除非你显式加 --prefer-source 参数。
- 对 dist 模式包（默认）：删了
.git没任何影响，本来就不走 Git - 对 source 模式包：删了
.git后，composer status就再也看不到它的修改，composer update也会降级为 dist 行为（如果配置允许） - 真正要保留 source 能力，得靠
repositories+"type": "vcs"显式声明，而不是靠手动留下的.git
CI/CD 中 vendor/.git 导致状态异常怎么防
GitHub Actions 或 GitLab CI 默认 shallow clone（--depth=1），导致 vendor/xxx/.git 缺少历史，git status 失败，进而触发 Composer 的 dirty 检查误判。
- CI 脚本中 clone 项目时加
--depth=0或至少--depth=10 - 或者在
composer install前运行：find vendor -name '.git' -type d -exec sh -c 'cd "$1" && git config --local advice.detachedHead false' _ {} \;，避免 Git 提示干扰 - 更彻底的做法：CI 中统一用
composer install --prefer-dist，从源头避开.git相关逻辑
真正麻烦的是那些没进 Git、只存在你本地 vendor 里的修改——它们不会出现在任何 diff 里，也不会被 composer status 捕获，却可能在下次 install 时无声消失。
