Composer命令失效主因是PATH未正确配置，需将C:\ProgramData\ComposerSetup\bin加入系统Path变量，并重启终端后用where composer验证路径是否生效。
composer --version 报“不是内部或外部命令”？先查 PATH 是否真生效
这不是 Composer 没装好，而是 Windows 根本没找到这个命令。关键不在安装动作本身，而在系统能否通过 PATH 定位到 composer.bat 或可执行文件。
实操建议：
- 打开「系统属性 → 高级 → 环境变量」，在 系统变量 的
Path里确认是否包含C:\ProgramData\ComposerSetup\bin（官方安装器默认路径） - 若用 XAMPP/PHPStudy 等集成环境，还要额外加 PHP 目录（如
C:\xampp\php），因为部分安装方式会把composer.bat放那儿 - 改完必须关掉所有 CMD/PowerShell 窗口，**新开一个**再试 —— 旧终端不会自动重读环境变量
- 验证命令：
echo %PATH%看输出里有没有你刚加的路径；再运行where composer，应返回具体 .bat 或 .exe 文件位置
COMPOSER_HOME 被覆盖后 autoload 失效？检查全局路径是否绝对且合法
一旦设了 COMPOSER_HOME，Composer 就完全抛弃默认路径（%APPDATA%\Composer），所有全局行为（composer global require、缓存、配置）都转向该目录。错一个字符，就全盘失效。
实操建议：
-
COMPOSER_HOME必须是绝对路径，Windows 下禁止用%USERPROFILE%或~，也不能有末尾反斜杠（C:\Users\Me\.composer\❌ →C:\Users\Me\.composer✅） - 设完立刻重启终端，然后运行
composer config --list --global，看顶部 “Global configuration file” 路径是否与你设置的一致 - 如果路径显示为
C:\Users\Me\AppData\Roaming\Composer\config.json，说明COMPOSER_HOME根本没生效（常见于设在用户变量却开了系统级 CMD） - Linux/macOS 同理：不能写
$HOME/.composer，得展开成/home/user/.composer
composer global require 安装的命令（如 laravel）找不到？PATH 没接上 vendor/bin
composer global require laravel/installer 成功 ≠ 你能直接敲 laravel。Composer 只负责把二进制文件放进 COMPOSER_HOME\vendor\bin，它不碰系统 PATH。
实操建议：
- 先确认
COMPOSER_HOME路径（见上一节），然后把%COMPOSER_HOME%\vendor\bin（Windows）或$COMPOSER_HOME/vendor/bin（macOS/Linux）加进系统Path - Windows 用户注意：如果
COMPOSER_HOME设的是用户变量，就加到「用户变量」的Path；如果是系统变量，就加到「系统变量」的Path - 加完重启终端，运行
echo %PATH%或echo $PATH确认该路径已存在；再运行where laravel（Win）或which laravel（macOS/Linux） - 别跳过这步直接跑
laravel new project——报错时你根本分不清是 Laravel 没装，还是 PATH 没通
多 PHP 版本共存下 composer install 行为异常？验证 php -r "echo PHP_BINARY;" 才算数
Composer 不选 PHP 版本，它只忠实地调用当前 shell 中 php 命令指向的解释器。你以为在用 PHP 8.2，实际可能是 PHP 7.4 在跑，autoload_static.php 生成逻辑就错了。
实操建议：
- 执行三连查：
php -v（版本）、which php（路径）、php -r "echo PHP_BINARY;"（Composer 内部真实调用路径）——三个输出必须一致 - 如果
which composer返回的是 shell 脚本（开头#!/usr/bin/env php），那COMPOSER_PHP环境变量无效，必须显式调用：/path/to/php8.2 /usr/local/bin/composer install - 切换 PHP 后，必须删掉
vendor和composer.lock重装，否则 autoload 映射和插件兼容性全乱 - 群晖、XAMPP、宝塔等集成环境尤其要注意：WebStation 或面板里绑定的 PHP 路径 ≠ 终端默认
php，务必用完整路径操作
composer install、dump-autoload、global require 都会静默失败或行为错位。
