Composer install 报错“CreateProcess failed”是Windows PATH超32767字符所致，需精简PATH、清理重复的Composer bin-dir路径，并优先使用composer exec替代全局PATH调用。
Composer install 报错 “The system cannot execute the specified program” 或 “CreateProcess failed”
这是 Windows 上最典型的环境变量长度超限表现，不是 Composer 本身出错，而是 Windows 的 PATH 环境变量总长度超过 32767 字符（Windows 10/11 限制），导致 PHP 进程无法 spawn 子进程（比如 git、php、zip 等命令）。Composer 在执行 install、update 时频繁调用这些工具，一旦 PATH 过长就会卡在某个 exec() 或 proc_open() 调用上，报错信息常含 CreateProcess failed 或提示找不到可执行文件。
解决思路不是“加长限制”，而是精简 PATH —— 尤其要清理掉 Composer 自身反复追加的 vendor bin 路径。
- 检查当前
PATH长度：echo %PATH% | powershell -Command "$input.Length"
- 定位重复路径：运行
composer config --global bin-dir，再手动检查该目录是否已被多次添加进系统或用户 PATH - 常见污染源：
%USERPROFILE%\AppData\Roaming\Composer\vendor\bin被 GUI 工具（如某些 IDE 插件、旧版 Laravel Installer）反复写入 PATH 多次
如何安全清理并固化 Composer 的 bin-dir 路径
关键原则：只让一个权威位置生效，且不依赖 PATH 查找。Composer 默认会把可执行脚本（如 laravel、phpunit）软链/复制到 bin-dir，但如果你把它加进 PATH，又没控制好唯一性，就极易爆炸。
- 执行
composer config --global bin-dir查看当前全局 bin 目录（通常是%APPDATA%\Composer\vendor\bin） - 用系统设置 → 高级系统设置 → 环境变量，彻底删除所有指向该目录的 PATH 条目（包括用户和系统两级）
- 改用绝对路径调用 bin 脚本：比如直接运行
"%APPDATA%\Composer\vendor\bin\laravel.bat"，绕过 PATH 解析 - 若必须进 PATH，只保留一条，且放在 PATH 开头（避免被其他同名命令覆盖），同时确保该路径下没有重复的 .bat/.exe 文件
禁用 Composer 自动修改 PATH 的行为
某些旧版 Composer 安装器（尤其是通过 Composer-Setup.exe 安装的）会在注册表或启动脚本里偷偷往 PATH 写路径，后续升级不会自动清理。更隐蔽的是，部分项目级 composer.json 中的 scripts 可能调用 composer config bin-dir 并拼接 PATH，造成动态污染。
- 检查注册表项：
HKEY_CURRENT_USER\Environment\PATH和HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment\PATH，删掉可疑条目 - 搜索本地磁盘中的
*composer*.ps1、*composer*.bat，特别是%USERPROFILE%\Documents\WindowsPowerShell\profile.ps1或%USERPROFILE%\AppData\Local\Programs\Git\cmd\start-ssh-agent.cmd类脚本 - 在项目根目录运行
composer run-script --list，排查是否有 script 修改了环境变量
替代方案：用 composer exec 避开 PATH 依赖
如果你只是想运行 vendor 里的工具（如 phpunit、php-cs-fixer），根本不需要把它们暴露到全局 PATH —— Composer 提供了更干净的方式：
composer exec phpunit -- --version composer exec php-cs-fixer fix src/
它会自动在当前项目的 vendor/bin 下查找命令，并用项目锁定的 PHP 版本执行，完全不经过系统 PATH。这对 CI/CD 和多项目协作尤其稳定。
注意：composer exec 是 Composer 2.2+ 原生支持的；低版本可用 composer run-script 模拟，但需先在 composer.json 的 scripts 里声明。
真正麻烦的从来不是 Composer，是 Windows 对 PATH 的僵硬限制和各种工具对它的滥用。少加一条 PATH，多用一次 composer exec，比调注册表或改组策略实在得多。
