composer国内镜像下载的dist包默认无.git目录，因dist是上游构建的发布态zip归档，本身不包含.git；仅--prefer-source或vcs仓库等触发git clone时才可能保留.git。
Composer 通过国内镜像下载的包默认走的是 dist 模式（ZIP 包），不是 git clone，所以天然不包含 .git 目录——这不是镜像“丢文件”，而是设计如此。
为什么 dist 包里没有 .git 目录
国内镜像（如阿里云、腾讯云）只同步 Packagist 的 dist 归档（zip 或 tar），这些归档由上游仓库自动构建生成，本身就不打包 .git 文件夹。Composer 下载时直接解压 ZIP，自然没 .git。
-
dist包是发布态产物，目标是运行时最小依赖，体积小、校验快、无需 Git 工具 -
source模式（git clone）才带.git，但需要系统有git命令且满足触发条件 - 镜像不参与构建过程，只做 HTTP 缓存代理，无法也无权往 ZIP 里塞
.git
哪些情况会触发 source 模式（从而可能有 .git）
只有明确要求源码时，Composer 才会尝试走 git clone，此时是否真能拿到 .git 取决于你本地环境和包配置：
- require 版本含
dev-前缀，如"monolog/monolog": "dev-main" - 项目
composer.json中设置了"minimum-stability": "dev"且未锁死稳定版 - 显式用了
--prefer-source或环境变量COMPOSER_PREFER_SOURCE=1 - repositories 中定义了
"type": "vcs"（比如私有 GitHub 地址）
注意：即使满足上述条件，如果系统没装 git 或镜像不支持 source 协议（绝大多数国内镜像只提供 dist），Composer 仍会 fallback 到 dist 并静默丢弃 .git。
想保留 .git 目录？别依赖镜像，改用 VCS 直连
国内镜像本身不提供 source 能力，强行让它返回 .git 不现实。真需要源码和 Git 历史，唯一可靠路径是绕过镜像，直连原始仓库：
- 临时禁用镜像：
composer config --global repo.packagist composer https://packagist.org - 确保系统已安装
git且在PATH中（git --version可用） - 加
--prefer-source安装：composer require vendor/package --prefer-source - 或锁定为
vcs类型仓库，在repositories中手动声明 GitHub URL 和type: "vcs"
这会跳过所有镜像，直接 git clone 远程仓库——但代价是慢、依赖网络、需认证（尤其私有库）。
误以为“少了 .git”是 bug？先确认你真需要它
99% 的生产环境不需要 .git 目录：Composer 安装的包是依赖项，不是你正在开发的代码。删掉 .git 反而更安全（避免意外提交第三方代码）、更轻量。
- 调试时想看源码？用 IDE 的 “Go to Definition” 或
composer show -p vendor/package查路径 - 需要修改包代码？应 fork 后用
repositories+type: "vcs"替换，而不是靠本地.git - CI 构建失败报 “no git dir”？大概率是某插件或脚本硬编码依赖
.git，该修脚本，不是换镜像
真正容易被忽略的是：有人把 --prefer-source 当成“保证有 .git” 的开关，却忘了它生效的前提是 git 可用 + 源仓库可访问 + 镜像不拦截 —— 三者缺一，就退回 dist，且不报错。
