Windows上composer global require安装的命令找不到，根本原因是%APPDATA%\Composer\vendor\bin未加入用户级PATH环境变量，需手动添加该绝对路径、关闭并重开所有终端验证echo %PATH%及命令执行。
Windows 上 composer global require 安装的命令找不到，不是 Composer 没装好，而是 PATH 没配对——这是唯一且最常被忽略的环节。
全局命令找不到？先确认 bin 目录路径是否真实存在
Composer 从不自动把 ~/.composer/vendor/bin（Windows 是 %APPDATA%\Composer\vendor\bin）加进系统 PATH。它只负责把可执行文件放进这个目录，其余全靠你手动补全。
- 运行
composer config --global home查出全局根目录，再拼上\vendor\bin就是真实路径（例如C:\Users\Alice\AppData\Roaming\Composer\vendor\bin） - 用文件资源管理器打开该路径，确认里面真有你要的命令（比如
laravel.bat、phpunit.bat） - 如果目录不存在或为空，说明
composer global require执行失败，或包本身没声明"bin"字段
PATH 怎么加？Windows 用户必须分清用户级和系统级
在 Windows 上，PATH 加错位置会导致新开终端仍无效，尤其是用 Git Bash 或 VS Code 终端时容易误判。
- 推荐加到「用户变量」里的 PATH，而不是系统变量：控制面板 → 系统 → 高级系统设置 → 环境变量 → 用户变量 → PATH → 新建
- 粘贴完整绝对路径，不要用
%APPDATA%占位符（PowerShell/CMD 会展开，但 Git Bash 不会） - 加完必须关闭所有终端窗口，重新打开 CMD/PowerShell/VS Code —— 旧终端不会重载 PATH
- 验证是否生效：在新终端里运行
echo %PATH%，搜索你刚加的路径；再直接敲laravel -V看是否响应
为什么 composer config --global bin-dir 不起作用？
这个配置项只影响 composer install 时项目级 vendor/bin 的位置，和全局命令完全无关。它不控制 composer global require 输出的二进制文件放哪。
-
bin-dir是项目级配置，全局设了也无效（Composer 2.x 会静默忽略） - 全局命令永远固定放在
%APPDATA%\Composer\vendor\bin，不能通过 config 改变 - 想改这个位置？只能设
COMPOSER_HOME环境变量，但风险高：一旦路径权限不对或格式错误（如含空格未引号），composer global全部失效
认证和镜像类配置必须用 --global 显式写入
Windows 下很多人在 PowerShell 里漏掉 --global，结果把 GitHub Token 或私有源账号写进了当前项目 composer.json，导致换项目就报 auth 错误。
- 设阿里云镜像：
composer config --global repos.packagist composer https://mirrors.aliyun.com/composer/ - 设 GitHub Token：
composer config --global github-oauth.github.com your_token_here - 设私有仓库账号：
composer config --global http-basic.repo.example.com username password - 漏掉
--global？命令不会报错，但配置只存在于当前目录下的composer.json，毫无全局意义
真正卡住人的从来不是 Composer 装没装上，而是 %APPDATA%\Composer\vendor\bin 这个路径有没有进 PATH、进的是哪个用户的 PATH、以及终端有没有重载——这三个点串起来，才是 Windows 下全局命令能跑通的最小闭环。
