Mac装Laravel本质是装Composer，需用Homebrew安装并配置PATH；PHP版本须≥8.2且启用必要扩展；镜像源异常时应清缓存或切回官方源。
Mac 上装 Laravel 依赖，本质是装 Composer，不是装 Laravel。只要 composer 能正常运行、能执行 composer create-project laravel/laravel，Laravel 就算“装好了”——框架本身是靠 Composer 下载的，不是系统级安装。
Composer 安装失败：/usr/local/bin/composer: No such file or directory
这是最常见的报错，说明 composer 命令根本没进系统 PATH，或者安装压根没成功。
- 别用
curl -sS https://getcomposer.org/installer | php然后手动挪文件——容易权限错、路径错、PHP 版本不匹配 - 直接用 Homebrew：
brew install composer（前提是已装 Homebrew；没装就先brew install --cask homebrew/cask-versions/php@8.2再装 composer） - 验证是否生效：
which composer应该输出/opt/homebrew/bin/composer或/usr/local/bin/composer；composer --version要能打印版本号 - 如果
which composer无输出，检查 shell 配置文件（~/.zshrc或~/.bash_profile）里有没有export PATH="/opt/homebrew/bin:$PATH"这类语句，没有就加上，然后source ~/.zshrc
Laravel 创建项目时卡在 “Resolving dependencies” 或报 “Your requirements could not be resolved”
这不是网络问题，大概率是 PHP 版本或扩展不满足 Laravel 当前版本要求。
- Laravel 11 要求 PHP ≥ 8.2；Laravel 10 要求 ≥ 8.1；Mac 自带的 PHP 是过时的（通常 8.1 以下），不能用
- 用 Homebrew 装指定 PHP 版本：
brew install php@8.2，再确认php -v输出的是 8.2.x - 确保启用了必要扩展：Laravel 至少需要
mbstring、xml、curl、openssl、json、pdo；用php -m | grep -E "(mbstring|xml|curl|openssl|json|pdo)"检查 - 如果扩展缺失，Homebrew 装的 PHP 通常自带这些，但可能没加载：检查
php --ini显示的配置路径，确认extension=mbstring.so这类行没被注释掉
composer create-project 执行后提示 “Could not find package laravel/laravel”
不是包名错了，是 Composer 镜像源或网络策略导致的元数据拉取失败。
- 先试
composer clear-cache清缓存 - 临时切回官方源：
composer config -g repo.packagist composer https://packagist.org - 国内用户常配阿里云镜像，但阿里源偶尔同步延迟或证书异常，可临时禁用：
composer config -g repo.packagist false（注意：false 是关闭镜像，不是字符串 "false"） - 如果仍失败，加
-vvv参数看具体卡在哪一步：composer create-project laravel/laravel myapp -vvv，重点看最后一段错误日志里是不是Connection refused或SSL certificate problem
真正麻烦的从来不是命令敲几遍，而是 PHP 版本和 Composer 镜像源这两个点悄悄咬住你——一个藏在 php -v 后面，一个藏在 composer config -g repo.packagist 里，不查就永远在重试。
