where composer无输出说明PATH未正确配置，需将C:\ProgramData\ComposerSetup\bin（不含文件名）加入系统变量Path，关闭所有终端后重开验证；laravel命令找不到则需将%APPDATA%\Composer\vendor\bin加入用户变量Path。
where composer 无输出？先确认 PATH 加的是 bin 目录，不是文件名
终端报 composer 不是内部或外部命令，本质是系统根本没在 PATH 里找到可执行文件。运行 where composer（Windows）或 which composer（Linux/macOS），如果没返回任何路径，说明环境变量加错了位置或压根没生效。
官方 Windows 安装器默认把 composer.bat 放在 C:\ProgramData\ComposerSetup\bin，这个路径必须完整加入「系统变量」→ Path，不能只加到「用户变量」，也不能误加成 C:\php 或 C:\xampp\php 这类 PHP 目录。
- 路径末尾不能有多余空格、中文、反斜杠（
C:\ProgramData\ComposerSetup\bin\就会失效） - 改完必须关闭所有已打开的 CMD/PowerShell/VS Code 终端，再新开一个——旧进程不会读新
PATH - 验证方式：运行
echo %PATH%看输出里是否含你刚加的路径；再跑一次where composer，应返回类似C:\ProgramData\ComposerSetup\bin\composer.bat
laravel 命令找不到？%APPDATA%\Composer\vendor\bin 没进 PATH
composer global require laravel/installer 成功 ≠ laravel -V 能运行。全局安装的二进制文件（如 laravel、phpunit）实际放在 %APPDATA%\Composer\vendor\bin（Windows）或 ~/.config/composer/vendor/bin（Linux/macOS），和 composer.bat 所在目录完全无关。
别猜路径，直接运行：composer config --global bin-dir --absolute
输出的就是你该加进 PATH 的真实路径。
- Windows：把这个路径加进「用户变量」→
Path（不是系统变量） - macOS/Linux：写进
~/.zshrc或~/.bashrc，例如：export PATH="$(composer global config bin-dir --absolute):$PATH" - 加完必须重载配置：
source ~/.zshrc或新开终端；Git Bash 还要单独编辑~/.bashrc并加export PATH="$APPDATA/Composer/vendor/bin:$PATH"
PHP_BINARY 设置无效？composer.bat 不认这个变量
你在系统变量里设了 PHP_BINARY=C:\xampp\php\php.exe，但 composer --version 仍报错？因为官方 composer.bat 是批处理脚本，内部写死调用 php 命令：php "%~dp0composer.phar" %*，完全忽略 PHP_BINARY。
验证方法：用记事本打开 composer.bat，搜 php "，基本能看到这行。
- 最稳解法：删掉
composer.bat，改用php composer.phar方式调用（需确保php在PATH中） - PowerShell 中可加函数：
function composer { php C:\tools\composer.phar @args } - 次选方案：手动编辑
composer.bat，把php替换成绝对路径，例如"C:\xampp\php\php.exe"（含英文双引号，路径含空格时必加）
路径含中文导致 realpath() returned false？必须全路径英文化
项目路径含中文（如 C:\Users\张三\project）、XAMPP 安装在 C:\开发工具\xampp、甚至 Windows 用户名是中文，都会触发 PHP 底层 realpath() 和 scandir() 崩溃，报 Invalid argument 或静默退出，composer --version 可能正常，但 install 一跑就挂。
这不是 Composer 配置问题，而是 Windows 终端编码（GBK）与 PHP 内部（UTF-8）不一致导致的硬伤，换镜像、改 composer.json 都绕不过去。
- 唯一可靠解法：把项目、PHP 安装目录（如 XAMPP）、
COMPOSER_HOME、PATH中所有路径全部改为纯英文，不含空格和特殊符号（如@、!） - 例如：项目移到
C:\projects\myapp，XAMPP 重装到C:\xampp-dev - 用户名含中文时，
%APPDATA%\Composer天然带中文路径，建议通过setx COMPOSER_HOME "D:\my-composer"指向纯英文路径，并手动迁移auth.json和config.json
