根本原因是Composer安装路径未加入系统PATH环境变量，Linux/macOS需将~/.composer/vendor/bin加入~/.bashrc或~/.zshrc，Windows需在环境变量Path中添加%APPDATA%\Composer\vendor\bin；网络问题、Windows Defender扫描、M1/M2架构下PHP扩展缺失也会导致各类异常。
Composer命令提示“command not found”
根本原因不是没装，而是系统压根不知道composer在哪。Linux/macOS下它默认装在~/.composer/vendor/bin/或~/bin/，Windows则是%APPDATA%\Composer\vendor\bin——这些路径都不在系统默认的$PATH里。
- Linux/macOS：把
~/.composer/vendor/bin加进$PATH，推荐写进~/.bashrc或~/.zshrc（别只改当前终端的临时变量） - Windows（CMD/PowerShell）：右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“用户变量”里找到
Path，新增一行：%APPDATA%\Composer\vendor\bin - 改完必须新开终端生效；Windows还要确认
composer.bat确实存在该路径下（重装Composer时勾选“Add to PATH”最省事）
全局安装后composer能运行，但composer create-project报错找不到包
这是网络或镜像问题，不是PATH配置失败。Composer默认走国外源，国内直连经常超时或返回空响应，错误常表现为Could not find package xxx或Connection timed out。
- 优先换阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 如果用的是PHP 8.2+，某些老项目依赖的包可能已弃用，需加
--ignore-platform-reqs跳过PHP版本检查（慎用，仅调试） - 执行前先
composer clear-cache，避免本地缓存污染导致误判
Windows上composer install卡在“Loading composer repositories”
不是网络慢，是Windows Defender实时防护在扫描每个下载的zip包，尤其遇到大型包（如laravel/framework）会明显卡住，现象是CPU低、网络流量小、进度条不动。
- 临时关闭Defender实时保护（设置→更新与安全→Windows 安全中心→病毒和威胁防护→管理设置→实时保护→关）
- 或者把项目目录加到Defender排除列表（同上路径→添加或删除排除项）
- 不建议用
composer install --no-plugins硬绕，很多项目依赖插件初始化autoload，跳过会导致后续Class not found
Mac M1/M2芯片上composer global require laravel/installer报错
本质是PHP扩展兼容性问题。M1原生PHP（如通过Homebrew装的php@8.2）默认不带openssl或curl扩展，而Composer全局命令依赖它们发起HTTPS请求。
- 先确认扩展是否加载：
php -m | grep -E 'openssl|curl'，缺哪个就补哪个 - Homebrew用户：运行
brew reinstall php@8.2（替换为你实际的PHP版本），它会自动重装所有依赖扩展 - 别手动改
php.ini去开扩展——M1上很多扩展.so文件路径变了，重装比手动配更可靠
