Laravel环境搭建教程及配置指南

本文是一份直击痛点的 Laravel 开发环境搭建实战指南，聚焦新手最常遭遇的四大“静默失败”场景：`php artisan serve` 启动报错、`.env` 配置修改不生效、MySQL 连接被拒、以及 Composer 安装非预期版本——不讲空泛理论，而是用精准命令、平台差异处理（macOS/Linux/Windows/Docker）和关键原理（如配置缓存机制、TCP vs Unix socket、LTS 版本锁定）层层拆解问题根源，帮你跳过无效重装，5 分钟定位并解决 90% 的环境卡点。

php artisan serve 启动失败？先别急着重装，90% 的问题出在端口、缓存或 .env 配置上，而不是 Laravel 本身。

php artisan serve 启动报 Address already in use 怎么办

这是开发中最常遇到的阻塞点：命令执行后提示 Address already in use，但页面打不开。根本原因不是 Laravel 坏了，而是 8000 端口被其他进程占用了。

解决步骤很直接：

• 查端口占用：lsof -i :8000（macOS/Linux）或 netstat -ano | findstr :8000（Windows），看 PID 是哪个进程
• 杀掉它：kill -9 [PID] 或 Windows 上用 taskkill /F /PID [PID]
• 换端口启动更省事：php artisan serve --port=8001，尤其当你同时跑 Valet、Docker 或另一个 Laravel 项目时
• 别用 sudo php artisan serve 绑定 80 端口——开发阶段完全没必要，反而可能因权限问题导致 storage 目录写入失败

.env 修改后 APP_DEBUG=true 不生效

Laravel 启动时只读一次 .env，之后全靠缓存。改完文件不清理缓存，等于白改。

必须执行这两步：

• php artisan config:clear —— 清掉配置缓存，强制重新加载 .env
• 确认 APP_ENV=local 和 APP_DEBUG=true 同时存在且拼写正确 —— APP_DEBUG 在 production 环境下永远无效
• 检查是否误提交了 .env 到 Git，或部署时覆盖了本地配置

MySQL 连接报 SQLSTATE[HY000] [1045] Access denied

这不是 Laravel 的错，是凭据没对上。常见于 MAMP、Docker 或 Homebrew 安装的 MySQL 实例。

重点排查这几项：

• DB_HOST 写 127.0.0.1，别写 localhost —— 后者在很多环境下会走 Unix socket，而 Laravel 默认走 TCP
• DB_DATABASE 必须是已存在的库名，Laravel 不会自动创建数据库，得自己先执行：mysql -u root -p -e "CREATE DATABASE myapp;"
• Homebrew 装的 MySQL 默认 root 密码为空；MAMP 默认是 root；Docker 容器里要看你 docker-compose.yml 里定义的 MYSQL_ROOT_PASSWORD
• 如果用 Docker，DB_HOST 应该填容器名（如 mysql），不是 127.0.0.1 —— 容器内 localhost 指向自身，不是宿主机

composer create-project 拉到的不是 LTS 版本

默认命令 composer create-project laravel/laravel 总是拉最新稳定版，但新版本可能带 breaking change 或依赖更高版本的 PHP/MySQL。

要稳，就明确指定 LTS：

• 装 Laravel 10（当前 LTS）：composer create-project laravel/laravel:^10.0 myapp
• 装 Laravel 11（需 PHP 8.2+、MySQL 8.0+）：composer create-project laravel/laravel:^11.0 myapp
• 装完立刻验证：php artisan --version，别只看 composer.lock 里的字段
• 别先拉默认版再手动改 composer.json 版本号 —— 很容易因依赖冲突卡在 composer install

环境变量和端口这类“看不见”的配置，比代码逻辑更容易让新手卡住半天。它们不报语法错误，却让整个流程静默失败。每次改完 .env 或换运行方式，记得多问一句：我清缓存了吗？端口空着吗？host 对得上实际服务位置吗？

好了，本文到此结束，带大家了解了《Laravel环境搭建教程及配置指南》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！