必须先创建 .env 文件再运行 php artisan key:generate，否则命令失败或静默跳过；mac 上常见原因包括 .env 缺失、openssl 扩展未启用、php 版本不匹配或权限不当。
必须先有 .env 文件，再运行 php artisan key:generate，否则命令会失败或静默跳过。
为什么 key:generate 在 Mac 上常报错或没反应
Mac 环境下（尤其是 macOS Sonoma + ARM64）常见问题不是命令本身失效，而是前置条件不满足：
-
.env文件缺失：Laravel 11 启动时严格检查该文件存在性；key:generate默认只更新已有.env中的APP_KEY=行，不会自动创建文件 - PHP 权限或扩展缺失：若
php -m | grep openssl无输出，key:generate会因缺少加密支持直接崩溃（Laravel 11 强制依赖openssl） - 终端用了错误的 PHP 版本：Homebrew 安装的
php@8.2默认路径是/opt/homebrew/bin/php，但 shell 可能仍调用系统自带 PHP（版本过低或无扩展） -
.env文件权限太松：Mac 的 Finder 有时会设为 644，而 Laravel 建议设为600，否则部分部署脚本会拒绝写入
php artisan key:generate 在 Mac 上的正确执行顺序
进入项目根目录后，按顺序执行以下操作（缺一不可）：
- 确认
.env存在：cp .env.example .env（Windows 用户用copy，Mac/Linux 统一用cp） - 检查 PHP 版本和扩展：
php -v必须 ≥ 8.2，且php -m | grep -E "^(openssl|mbstring)$"两行都要有输出 - 确保当前 shell 调用的是 Homebrew PHP：
which php应返回/opt/homebrew/bin/php（Apple Silicon）或/usr/local/bin/php（Intel） - 运行密钥生成：
php artisan key:generate—— 不加--force也行，因为默认非生产环境不拦截 - 验证是否写入：
grep '^APP_KEY=' .env应输出类似APP_KEY=base64:J63qRTDLub5NuZvP+kb8YIorGS6qFYHKVo6u7179stY=
生产环境部署时 Mac 本地预生成的密钥不能直接复用
Laravel 11 的加密机制对环境敏感，同一 APP_KEY 在不同环境可能引发 session 失效、Cookie 解密失败等静默问题：
- 开发机（Mac）生成的密钥仅用于本地调试，
APP_ENV=local下可接受 - 生产服务器（哪怕也是 Mac）必须独立运行
php artisan key:generate --force，且.env中需明确设APP_ENV=production - 不要把本地
.env提交进 Git，更不要在 CI/CD 流程中硬编码密钥值——应通过部署脚本自动生成 - 若用 Docker 部署 Mac 本地开发镜像，ENTRYPOINT 中应包含
cp .env.example .env && php artisan key:generate --force
最易被忽略的一点：Laravel 11 启动时若读不到有效 APP_KEY，不会立即报错，而是等到首次需要加密（比如写 session、生成密码重置链接）时才抛出 No application encryption key has been specified。所以别只看首页能打开就认为密钥已生效。
