Mac终端Laravel权限报错需按类型精准处理：Permission denied修复目录权限，command not found配置PATH，zsh操作受限开启全盘访问，file_put_contents失败则chmod storage/和bootstrap/cache/。
Mac终端权限报错，通常不是Laravel本身的问题，而是系统对命令执行路径、文件写入位置或PHP/Composer环境的限制。重点不在“重装”，而在**准确定位报错类型并针对性处理**。
先看报错关键词，快速判断类型
打开终端，运行命令时如果出现类似以下提示，对应不同解决方向：
-
“Permission denied”：常见于执行
composer create-project或php artisan时，目标目录（如/usr/local/bin或项目storage/）无写权限； -
“command not found: laravel”：说明
laravel/installer未正确全局安装，或PATH未包含其二进制路径； -
“zsh: operation not permitted”（macOS Monterey 及更新系统）：是系统完整性保护（SIP）或全盘访问权限限制，尤其影响
brew、composer安装到受保护路径； -
“file_put_contents(...): failed to open stream: Permission denied”：多见于
php artisan key:generate或缓存写入失败，指向storage/和bootstrap/cache/目录权限不足。
分步修复常用权限问题
按顺序操作，多数情况可解决：
- 确保 Composer 已安装且可用：
which composer，若无输出，用brew install composer（推荐）或官网脚本安装； - 避免使用
sudo运行 Composer 或 Artisan 命令——这会引发后续更多权限混乱； - 全局安装 Laravel Installer 并设好 PATH：
composer global require laravel/installer
然后将 Composer 全局 bin 路径加入 shell 配置（如~/.zshrc）：echo 'export PATH="$HOME/.composer/vendor/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc； - 创建项目时，选你有完全控制权的目录（如
~/Sites或~/Code），别放在/System、/usr或桌面根目录（macOS 对桌面有额外沙盒限制）； - 项目生成后，立即修复存储目录权限：
chmod -R 775 storage/ bootstrap/cache/
若仍报错，可临时放宽（开发环境安全前提下）：sudo chmod -R 777 storage/ bootstrap/cache/；
macOS 新系统（Ventura/Sonoma）特别注意
如果你用的是 macOS 13+，终端可能默认被系统限制“全盘访问”：
- 打开「系统设置 → 隐私与安全性 → 全盘访问」，找到你用的终端（Terminal.app 或 iTerm2），勾选启用；
- 若用 VS Code 内置终端，需单独为
Visual Studio Code.app授予全盘访问； - Homebrew 安装路径（
/opt/homebrew）在 Apple Silicon Mac 上默认受保护，务必用官方推荐方式安装：arch -arm64 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
验证是否真正成功
不依赖浏览器，用终端快速确认：
- 进入项目目录后，运行
php artisan tinker——能进入交互界面即 PHP 和框架加载正常； - 运行
php artisan key:generate不报错，且.env中APP_KEY已填充； - 运行
php artisan serve，访问http://127.0.0.1:8000显示 Laravel 欢迎页。
