刚装好Laravel执行php artisan serve打不开页面，主因是.env缺失或APP_KEY未生成、8000端口被占、PHP版本与Laravel不兼容、必要扩展未启用或storage目录不可写。
刚装好 Laravel 就执行 php artisan serve 却打不开页面、报错或没反应？别急，90% 的问题集中在几个关键环节——不是框架坏了，而是环境卡在了启动前的“临门一脚”。下面直击最常出问题的四个地方，帮你快速定位、一步到位。
.env 配置与密钥缺失
没有 .env 文件或 APP_KEY 未生成，Laravel 根本无法初始化应用。空白页、“Whoops”页面、500 错误往往由此开始。
- 确认项目根目录下存在
.env文件；若没有，运行cp .env.example .env（Linux/macOS）或复制重命名（Windows） - 立即执行
php artisan key:generate，确保.env中出现APP_KEY=base64:... - 打开
.env检查：APP_ENV=local和APP_DEBUG=true必须同时存在且拼写正确——改完后务必运行php artisan config:clear，否则修改不生效
端口被占或监听失败
命令执行后提示 Address already in use 或 Failed to listen on 127.0.0.1:8000，说明 8000 端口已被占用，不是 Laravel 启动失败，而是“抢不到位置”。
- 查占用：macOS/Linux 运行
lsof -i :8000，Windows 运行netstat -ano | findstr :8000，记下 PID - 杀进程：macOS/Linux 执行
kill -9 [PID]，Windows 执行taskkill /F /PID [PID] - 临时绕过：直接换端口启动，例如
php artisan serve --port=8001，开发阶段无需死守 8000
PHP 版本与 Laravel 不兼容
执行命令时直接报 Fatal error、Call to undefined function 或 Uncaught TypeError，极大概率是 PHP 太新，而项目用的是老版本 Laravel。
- 先查项目版本：运行
grep '"laravel/framework"' composer.json，如显示"^6.2"就是 Laravel 6.x，只支持 PHP 7.2–7.4 - 再查当前 PHP：运行
php -v，若为 8.1+，旧版 Laravel 会因废弃函数（如str_slug()）、类型系统变更而崩溃 - 解决方案不是升级 Laravel，而是切换 PHP 版本——用
phpbrew、asdf或 XAMPP/MAMP 切到匹配的 PHP 7.x
必要扩展未启用或权限不足
命令无响应、白屏、或提示 “fileinfo extension missing”，说明 PHP 环境本身就不完整；而 storage 和 bootstrap/cache 目录不可写，则会导致日志写不进、视图编译失败、缓存生成报错。
- 检查
fileinfo扩展：运行php -m | grep fileinfo，若无输出，需编辑php.ini，取消;extension=fileinfo前的分号，重启 PHP - 修复写入权限：Linux/macOS 运行
chmod -R 775 storage bootstrap/cache；若仍报错，补一句sudo chown -R $USER:www-data storage bootstrap/cache（Ubuntu/Debian） - Windows 用户请右键点击这两个文件夹 → 属性 → 安全 → 编辑 → 给当前用户勾选“修改”和“写入”
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
