答案是先新开终端执行git --version和where/git which git验证Git是否可调用且PATH配置正确，若失败则说明系统Git未安装或未加入PATH，而非Composer故障。
composer install 报 git is not recognized 怎么确认是不是 Git 没装好
不是 Composer 坏了，是它在特定场景下必须调用 git 命令——比如你 require 了 "monolog/monolog": "dev-main"，或本地 composer.lock 记的是 source 提交哈希，又或者运行时加了 --prefer-source。这时候它会尝试执行 git clone，找不到命令就直接崩。
别急着重装，先快速验证：
- 新开一个 CMD 或 PowerShell，运行
git --version—— 如果报错，说明系统根本没识别到git - 运行
where git（Windows）或which git（Linux/macOS），看是否返回类似C:\Program Files\Git\cmd\git.exe的路径 - 如果已安装 Git for Windows，但
where git无输出，大概率是安装时漏选了 “Add Git to the system PATH” 选项 - 改完环境变量后，必须关掉所有终端再重开，否则不生效
Git 安装时哪些选项直接影响 Composer 能不能用
用官方 Git for Windows（Git-x.x.x-64-bit.exe）安装，关键就三步，其他都可默认：
- 在 “Adjusting your PATH environment” 页面，**必须选中 “Git from the command line and also from 3rd-party software”** —— 这是让
composer进程能调用git的唯一方式 - “Configuring the line ending conversions” 保持默认：Checkout Windows-style, commit Unix-style
- “Configuring the terminal emulator” 选默认的 “Use Windows’ default console window” 即可
装完立刻新开终端，跑 git --version 和 composer install（用一个含 dev 分支依赖的最小 composer.json 测试），比看安装日志靠谱得多。
为什么有时候 git 装好了，composer install 还是走不了 source
即使 git 可用，composer install 仍可能跳过 Git 克隆、强行走 dist ZIP 包——这不是故障，是策略性降级。触发条件包括：
仅从仓库的暂存文件生成 Git 提交消息。当用户要求 Codex 根据暂存更改、缓存差异、Git 索引或已通过 `git add` 添加的文件来编写、起草、创建或建议提交消息时使用；切勿代表用户执行提交操作。
- 当前网络策略禁止出向
git://或 SSH 端口（如公司防火墙拦截 22 端口） -
auth.json缺失或 token 权限不足，导致私有 Git 仓库认证失败（此时 Composer 会静默 fallback 到 dist） - 包的
composer.json中"source"类型被禁用，或镜像源（如阿里云）只提供 dist 归档 - 运行了
composer install --prefer-dist，显式要求跳过 source
想强制走 Git？删掉 vendor/ 和 composer.lock，再跑 composer install --prefer-source，同时确保 git clone 手动执行能通（例如 git clone https://github.com/monolog/monolog.git）。
内网环境里，Git 不是必须的，但得知道它什么时候会被绕过
内网部署时，很多人以为只要配好私有 Packagist（如 Satis）或 Nexus 代理，就彻底不用 Git。其实不然：
- 若
repositories中配置了 type 为vcs的私有 Git 地址（如"url": "git@intranet.company.com:team/lib.git"），Composer 仍会调用git命令克隆——这时内网 Git 服务器必须可达，且 SSH key 或 HTTP token 配置正确 - 若用的是 type
composer的私有源（如 Satis），且所有包都生成了 dist ZIP，则git完全不会被调用 -
composer diagnose会明确告诉你 “Git binary found: /usr/bin/git”，但它不会告诉你这个 Git 能不能连上你的内网仓库——得自己试git ls-remote
最容易被忽略的点：CI 流水线里 Git 可用，但用的是系统全局 Git；而开发机上用了某 IDE 内置 Git（比如 SourceTree 自带的），PATH 里没它，composer 就找不到——环境一致性比工具本身更难搞。
