装完 laravel 项目后第一步是验证 php artisan serve 能正常启动并访问 http://127.0.0.1:8000 显示默认欢迎页；若失败需检查 .env 是否存在及生成、php 扩展是否齐全、storage 和 bootstrap/cache 目录是否可写。
装完 Laravel 项目后，第一步不是写路由、不是配数据库，而是确认 php artisan serve 能跑通，并且首页返回的是 Laravel 默认欢迎页（含 “You did it!” 或类似文案）——否则后续所有开发都建立在不可靠基础上。
验证本地服务是否真正启动成功
很多人执行 php artisan serve 后看到 “Laravel development server started” 就以为好了，但实际可能卡在端口被占、PHP 扩展缺失、或 .env 未生成等环节。
- 打开浏览器访问
http://127.0.0.1:8000，必须看到 Laravel 欢迎页面；如果报错500 Internal Server Error，先看终端输出的错误行，大概率是.env文件缺失或权限问题 - 检查项目根目录是否存在
.env文件：没有就运行cp .env.example .env，再执行php artisan key:generate - 若提示
Class 'PDO' not found或mbstring extension is missing，说明 PHP 缺扩展，得回系统补装，不是 Laravel 本身的问题
确认 .env 配置已生效且可读
.env 不只是存配置的地方，它是整个应用启动时环境变量的源头。哪怕只改了一行 APP_DEBUG=true，也得确保它被正确加载。
- 修改
.env后必须清缓存：运行php artisan config:clear，否则旧值仍会从bootstrap/cache/config.php中读取 - 用
php artisan tinker进入交互模式，输入env('APP_NAME')看是否返回你设的值，而不是null - 别把
.env提交到 Git：确保.gitignore里有.env，否则密钥泄露风险极高
检查 storage 和 bootstrap/cache 目录是否可写
Laravel 运行时要往 storage/logs 写日志、往 bootstrap/cache 写配置/路由缓存。Windows 用户常忽略这点，Linux/macOS 用户则容易因权限组不一致导致失败。
- 执行
php -r "echo is_writable('storage') ? 'ok' : 'fail';"和同理检查bootstrap/cache - Linux/macOS 下常见修复命令：
chmod -R 775 storage bootstrap/cache，或更安全地用chown -R $USER:www-data storage bootstrap/cache - 如果用 Valet/Homestead，注意宿主机和虚拟机用户 UID 是否一致，否则 chmod 无效
很多“功能莫名不生效”的问题，其实卡在第一步的这三个检查点上——服务没真起来、.env 没生效、目录不可写。跳过它们直接写代码，等于在流沙上盖楼。
