Composer命令在Windows下报“不是内部或外部命令”根本原因是PATH未正确配置：需将C:\ProgramData\ComposerSetup\bin（官方安装路径）和PHP安装目录（含php.exe）同时加入系统环境变量PATH，并重启终端验证；where composer与where php均须有输出。
Composer 命令在 Windows 下报 “不是内部或外部命令”，90% 是环境变量没配对，而不是 Composer 没装好——PATH 里漏了路径、加错了目录、或者 PHP 自身没进 PATH，三者任一出错都会让 composer 彻底失联。
为什么 composer --version 总是失败
根本原因不是 Composer 本身坏了，而是系统找不到可执行入口。Windows 下的 composer 实际是 composer.bat（官方安装器生成）或你手动放的 composer.phar，它必须满足两个条件才能运行：
-
composer.bat或composer.phar所在目录已加入系统Path（注意：不是文件路径，是**目录路径**） -
php.exe本身也已在Path中，否则composer.bat启动时会直接报错或静默退出 - 若用的是手动下载的
composer.phar，且没配composer.bat，那必须确保当前 shell 能调用php，且php -v可执行
验证方法：新开 CMD，依次运行 where php 和 where composer；如果后者无输出，说明 Path 没生效或路径写错；如果前者无输出，先回头配 PHP。
COMPOSER_HOME 被误设后 autoload 失效
全局配置和插件依赖 COMPOSER_HOME 定位缓存、auth.json、vendor/bin 等关键路径。一旦设错，composer global require 安装的命令（如 laravel、phpunit）就找不到，甚至 composer install 会跳过 autoload 生成。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
COMPOSER_HOME必须是**绝对路径**，不能含%USERPROFILE%、~、$HOME等占位符 - 设完后必须重启所有终端窗口，旧窗口不会自动加载新环境变量
- 验证是否生效：
composer config --list --global输出顶部的 “Global configuration file” 路径必须与你预期一致 - 常见错误：把
COMPOSER_HOME设成C:\Users\Me\.composer，但实际目录是%APPDATA%\Composer（Windows 默认），导致全局 bin 路径错配
全局工具命令（如 laravel）找不到的真正原因
很多人以为 composer global require laravel/installer 成功后就能直接敲 laravel，其实这一步完全不依赖 Composer 配置，只取决于系统 Path 是否包含全局 bin 目录。
- 默认全局 bin 路径是
%APPDATA%\Composer\vendor\bin（Windows）或~/.composer/vendor/bin（macOS/Linux） - 这个路径必须手动加入系统
Path，官方安装器**不会自动帮你加**（即使勾选了 “Add to PATH”，也只加了composer自身路径，没加vendor/bin） - 如果你改过
COMPOSER_HOME，比如设为D:\composer，那真实 bin 路径就是D:\composer\vendor\bin，Path也得同步更新 - 验证：
echo %PATH%输出中必须能看到该vendor\bin路径；然后运行dir %APPDATA%\Composer\vendor\bin确认laravel.bat或laravel文件存在
国内源配置被忽略的隐蔽原因
执行了 composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 却发现 create-project 还是卡在 “Loading composer repositories…”，大概率是项目级配置覆盖了全局设置。
- 检查项目根目录下是否存在
composer.json，并查看其中是否有"repositories"字段——只要它存在，就会**完全屏蔽**全局镜像配置 - 临时验证：删掉项目
composer.json中的repositories段，再运行composer diagnose，看 “Repo packagist” 行是否显示你设的阿里云地址 - 更稳妥的做法：用
composer config --global repos.packagist false关闭官方源，再显式添加国内镜像，避免歧义 - 注意：2026 年起主流镜像已弃用
https://packagist.phpcomposer.com，务必用https://mirrors.aliyun.com/composer/或https://packagist.org的代理地址
PATH 和 COMPOSER_HOME 是两套独立路径体系，一个管“命令在哪”，一个管“配置和缓存在哪”；混淆二者是 Windows 下 Composer 最难排查的一类问题——改完任何一个，都必须关掉再开终端，否则看到的永远是旧状态。
