Mac安装Laravel 11需满足PHP 8.2+、Composer 2.5+及必需扩展（openssl/mbstring/tokenizer/xml/ctype/json/pdo），缺一不可；须用brew install php@8.3并强制链接，配置阿里云镜像，禁用laravel new，执行composer create-project指定"11.*"版本，chmod修正权限，cp .env.example后运行php artisan key:generate方可启动。
在Mac上安装Laravel框架必须先满足PHP 8.2+、Composer 2.5+、必需扩展启用这三项硬性条件，跳过任一环节都会导致composer create-project中途失败或php artisan key:generate静默退出，最终项目无法启动。
确认并安装兼容的PHP版本
运行php -v，若显示PHP 8.1.x或更低，或提示command not found，说明系统PHP不可用——macOS自带PHP不更新、无php-fpm、默认不带mbstring，Laravel 11会直接拒绝启动。
执行brew install php@8.3安装官方推荐版本；安装完成后必须运行brew link --force php@8.3，否则终端仍调用旧版PHP。
验证扩展是否全部启用：php -m | grep -E "openssl|mbstring|tokenizer|xml|ctype|json|pdo"。缺任何一项都需打开php --ini显示的php.ini路径，取消对应extension=xxx.so行前的分号注释。
安装并配置Composer
执行brew install composer——这是Mac上最稳的方式，避免curl管道安装引发的权限混乱和PATH错位。
检查composer --version输出是否≥2.5.0；若提示command not found，运行echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc（Apple Silicon）或echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc（Intel）。
国内用户立即配置阿里云镜像：composer config -g repo.packagist composer https://packagist.phpcomposer.com，否则拉取依赖极慢甚至超时中断。
创建Laravel 11项目
方法一：直接指定版本创建（推荐）
执行composer create-project laravel/laravel myapp "11.*" --no-interaction --prefer-dist。【必须加--no-interaction，否则交互式提问卡在“Would you like to install the Laravel Breeze starter kit?”导致进程挂起】
方法二：精确到小版本（适合生产环境锁定）
执行composer create-project laravel/laravel myapp "11.32.*" --prefer-dist——这是截至2026年9月17日的最新稳定子版本，已通过PHP 8.3全量测试。
⚠️ 不要用laravel new或composer global require laravel/installer，这两个方式在Laravel 11发布后未同步更新策略，大概率拉取到10.x分支或触发版本冲突。
初始化项目并启动服务
第一步：进入项目目录 → cd myapp
第二步：确保storage与bootstrap/cache可写 → chmod -R 755 storage bootstrap/cache。Mac上默认权限常为700，不改会导致日志写入失败、缓存生成报错。
第三步：复制环境文件 → cp .env.example .env。这一步不能跳过，否则php artisan key:generate会因找不到.env而静默失败。
第四步：生成应用密钥 → php artisan key:generate。该命令将自动写入APP_KEY到.env，是后续所有加密操作（如session、cookie）的前提。
第五步：启动开发服务器 → php artisan serve。默认监听http://127.0.0.1:8000，浏览器访问看到Laravel欢迎页即安装完成。
