必须立刻跑通php artisan serve、改通routes/web.php、让Blade视图正确渲染；因serve自动处理重写与资源托管，避免新手在Apache/Nginx配置中卡在规则或权限问题，而路由与视图验证是环境就绪的核心标志。
直接上手比看文档快，但必须立刻做三件事：跑通 php artisan serve、改通 routes/web.php、让一个 Blade 视图正确渲染。
为什么不能跳过 php artisan serve 直接配 Apache/Nginx
新手在本地开发阶段强行配置虚拟主机，90% 会卡在重写规则（.htaccess 或 nginx.conf）或权限问题上，而 php artisan serve 是 Laravel 内置的轻量级 PHP 开发服务器，它自动处理路由重写、静态资源托管和基础 MIME 类型，且默认监听 http://localhost:8000，无需额外服务进程。它不适用于生产，但对入门验证环境是否就绪极其可靠。
常见错误现象：
-
Could not open input file: artisan：没进项目根目录，或项目未通过composer create-project正确生成 -
PHP Warning: Module 'xxx' already loaded：php.ini中重复启用了扩展，检查extension=行是否重复 - 浏览器空白页但控制台无报错：确认
public/下有index.php，且storage/和bootstrap/cache/目录可写（Linux/macOS 执行chmod -R 775 storage bootstrap/cache）
routes/web.php 改完不生效？先查这三点
Laravel 的路由缓存只在生产环境启用，开发时改了 web.php 理论上立即生效。但如果页面没变，大概率是以下原因：
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
- 浏览器缓存了 301 重定向（比如你把
/改成/home后仍跳转旧地址）：用隐身窗口测试，或清空浏览器缓存 - 路由被中间件拦截：例如访问
/admin但没登录，会被重定向到/login；临时注释掉Route::middleware(['auth'])测试 - 定义了同名但更宽泛的路由在前：Laravel 按顺序匹配，
Route::get('/{slug}', ...)如果写在Route::get('/about', ...)前面，/about就永远进不去——把具体路由放前面，动态参数路由放后面
Blade 视图返回 500 错误但没提示？重点看 storage/logs/laravel.log
Blade 编译失败、变量未定义、模板继承路径错误都会导致 500，但开发服务器默认不显示详细错误（出于安全），真实错误全在日志里。
典型问题与对应修复：
-
View [welcome] not found：检查resources/views/welcome.blade.php是否存在，注意大小写和后缀名（必须是.blade.php，不是.php） -
Undefined variable: $name：在控制器中调用view('greeting', ['name' => 'John'])时传了数组，但视图里写了{{ $name }}—— 没问题；但如果漏传name键，就会炸；保险写法是{{ $name ?? 'Guest' }} -
Class 'App\Http\Controllers\SomeController' not found：新建控制器后没运行composer dump-autoload（Laravel 10+ 通常自动触发，但手动执行一次不亏）
.env 文件改了数据库配置却连不上？别只改文件
.env 变更不会实时生效，因为 Laravel 在启动时会把配置缓存到 bootstrap/cache/config.php。开发阶段可以不管缓存，但如果你之前执行过 php artisan config:cache，就必须清除：
- 运行
php artisan config:clear（清配置缓存） - 再运行
php artisan cache:clear（清通用缓存） - 最后确认
DB_CONNECTION值是mysql、pgsql或sqlite之一，拼错（如写成myql）会导致连接器根本加载失败，错误日志里只会显示“Driver not supported”
真正容易被忽略的是：MySQL 用户权限。即使 DB_HOST、DB_USERNAME 都对，如果该用户没被授权访问指定的 DB_DATABASE，php artisan migrate 会报 Access denied for user，而不是数据库不存在——此时需用 MySQL 客户端登录，执行 GRANT ALL ON your_db.* TO 'your_user'@'localhost'; FLUSH PRIVILEGES;。
