Composer命令报“不是内部或外部命令”是因PATH未生效，需手动将C:\ProgramData\ComposerSetup\bin添加到系统Path；global安装命令找不到则需将%APPDATA%\Composer\vendor\bin加入用户Path；还需启用php.ini中openssl、mbstring、curl、zip扩展，并正确设置COMPOSER_HOME为绝对路径。
composer命令报“不是内部或外部命令”
这是 Windows 上最常见、也最容易被误判的问题：不是没装好，而是 PATH 没生效。官方安装器勾选了 Add to PATH，但 UAC 权限、杀毒软件或系统策略常导致写入失败，PATH 里压根没有 composer.bat 的路径。
先运行 where composer —— 如果无输出，就确认没加进 PATH；再手动打开 C:\ProgramData\ComposerSetup\bin\，看是否存在 composer.bat 和 composer.phar：
- 不存在 → 重装 Composer-Setup.exe，并「以管理员身份运行」
- 存在 → 把
C:\ProgramData\ComposerSetup\bin（只到bin目录，不含文件名）添加到「系统变量」的Path中 - 必须关闭所有已打开的 CMD/PowerShell/VS Code 窗口，再新开一个终端验证
- 新开终端后执行
echo %PATH%搜索刚加的路径，再跑composer --version
composer global require 安装的命令找不到（如 laravel）
这和上一个问题无关，是另一个独立的 PATH 配置点：composer global require 下载的可执行文件（比如 laravel.bat）默认放在 %APPDATA%\Composer\vendor\bin，而这个路径跟 composer.bat 自身所在目录完全不重合。
正确做法是：
- 运行
composer config --global home查出全局根目录（例如C:\Users\Alice\AppData\Roaming\Composer） - 拼出完整路径：
%APPDATA%\Composer\vendor\bin（Windows 下等价于C:\Users\Alice\AppData\Roaming\Composer\vendor\bin） - 用资源管理器打开该路径，确认里面有
laravel.bat等文件；如果为空，说明global require执行失败，或包未声明"bin"字段 - 把这个
\vendor\bin路径单独添加到「用户变量」的Path中（不是系统变量，避免权限冲突） - 同样要关掉所有终端重开，再试
laravel -V
PHP 扩展缺失导致 install 卡住或报 SSL 错误
Composer 是 PHP 脚本，不是独立二进制程序，它严重依赖 CLI 环境下的扩展能力。Windows 下默认禁用关键扩展，缺一个就可能卡在 Resolving packages... 或报 SSL operation failed。
必须检查并启用以下扩展（在 php.ini 中取消注释）：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
extension=openssl（HTTPS 请求必需） -
extension=mbstring（包名解析、字符处理必需） -
extension=curl（网络请求底层支持） -
extension=zip（解压下载的包必需） - 改完重启终端，用
php -m | findstr "openssl mbstring curl zip"验证
COMPOSER_HOME 设错导致 global 命令静默失效
这个环境变量决定全局配置、缓存、vendor/bin 的根位置。设错一个斜杠、多一个引号、或用了 %USERPROFILE% 这类变量，composer global require 就会把命令装进错误目录，后续完全找不到，且不报错。
Windows 正确设置方式（在 CMD 中执行）：
setx COMPOSER_HOME "C:\Users\YourName\AppData\Roaming\Composer"
注意：
- 路径必须是绝对路径，不能含环境变量（如
%APPDATA%） - 引号仅用于包裹含空格的路径，但建议路径本身别带空格
- 设置后需新开终端，旧进程不会继承新变量
- 可通过
echo %COMPOSER_HOME%立即验证是否生效
真正容易被忽略的是：这个变量一旦设错，所有 global 行为都失效，但没有任何提示，你只会发现命令凭空消失。
